@bgord/tools 1.1.4 → 1.1.5

package/dist/filename-affix.vo.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod/v4";
+export declare enum FilenameAffixStrategy {
+    prefix = "prefix",
+    suffix = "suffix"
+}
+export declare const FilenameAffixError: {
+    readonly Type: "affix.type";
+    readonly Empty: "affix.empty";
+    readonly TooLong: "affix.too.long";
+    readonly BadChars: "affix.bad.chars";
+};
+export declare const FilenameAffix: z.core.$ZodBranded<z.ZodString, "FilenameAffix">;
+export type FilenameAffixType = z.infer<typeof FilenameAffix>;

package/dist/filename-affix.vo.js

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+export var FilenameAffixStrategy;
+(function (FilenameAffixStrategy) {
+    FilenameAffixStrategy["prefix"] = "prefix";
+    FilenameAffixStrategy["suffix"] = "suffix";
+})(FilenameAffixStrategy || (FilenameAffixStrategy = {}));
+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_-]+$/;
+export const FilenameAffix = z
+    .string(FilenameAffixError.Type)
+    .min(1, FilenameAffixError.Empty)
+    .max(32, FilenameAffixError.TooLong)
+    .regex(FILENAME_AFFIX_WHITELIST, FilenameAffixError.BadChars)
+    .brand("FilenameAffix");

package/dist/filename.vo.d.ts

@@ -1,6 +1,6 @@
 import { type BasenameType } from "./basename.vo";
 import { type ExtensionType } from "./extension.vo";
-import { type FilenameSuffixType } from "./filename-suffix.vo";
+import { FilenameAffixStrategy, type FilenameAffixType } from "./filename-affix.vo";
 export declare class Filename {
     private readonly basename;
     private readonly extension;
@@ -13,8 +13,12 @@ export declare class Filename {
     getExtension(): ExtensionType;
     withExtension(extension: ExtensionType): Filename;
     withBasename(basename: BasenameType): Filename;
+    withAffix(candidate: string, strategy: FilenameAffixStrategy): Filename;
+    withAffixSafe(affix: FilenameAffixType, strategy: FilenameAffixStrategy): Filename;
     withSuffix(candidate: string): Filename;
-    withSuffixSafe(suffix: FilenameSuffixType): Filename;
+    withSuffixSafe(affix: FilenameAffixType): Filename;
+    withPrefix(candidate: string): Filename;
+    withPrefixSafe(affix: FilenameAffixType): Filename;
     toString(): string;
     toJSON(): string;
 }

package/dist/filename.vo.js

@@ -1,7 +1,7 @@
 import { Basename } from "./basename.vo";
 import { Extension } from "./extension.vo";
+import { FilenameAffix, FilenameAffixStrategy } from "./filename-affix.vo";
 import { FilenameFromString } from "./filename-from-string.vo";
-import { FilenameSuffix } from "./filename-suffix.vo";
 export class Filename {
     basename;
     extension;
@@ -34,14 +34,30 @@ export class Filename {
     withBasename(basename) {
         return new Filename(basename, this.extension);
     }
+    withAffix(candidate, strategy) {
+        const affix = FilenameAffix.parse(candidate);
+        if (strategy === FilenameAffixStrategy.prefix) {
+            return new Filename(Basename.parse(`${affix}${this.basename}`), this.extension);
+        }
+        return new Filename(Basename.parse(`${this.basename}${affix}`), this.extension);
+    }
+    withAffixSafe(affix, strategy) {
+        if (strategy === FilenameAffixStrategy.prefix) {
+            return new Filename(Basename.parse(`${affix}${this.basename}`), this.extension);
+        }
+        return new Filename(Basename.parse(`${this.basename}${affix}`), this.extension);
+    }
     withSuffix(candidate) {
-        const suffix = FilenameSuffix.parse(candidate);
-        const basename = Basename.parse(`${this.basename}${suffix}`);
-        return new Filename(basename, this.extension);
+        return this.withAffix(candidate, FilenameAffixStrategy.suffix);
     }
-    withSuffixSafe(suffix) {
-        const basename = Basename.parse(`${this.basename}${suffix}`);
-        return new Filename(basename, this.extension);
+    withSuffixSafe(affix) {
+        return this.withAffix(affix, FilenameAffixStrategy.suffix);
+    }
+    withPrefix(candidate) {
+        return this.withAffix(candidate, FilenameAffixStrategy.prefix);
+    }
+    withPrefixSafe(affix) {
+        return this.withAffix(affix, FilenameAffixStrategy.prefix);
     }
     toString() {
         return this.get();

package/dist/index.d.ts

@@ -24,8 +24,8 @@ 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-affix.vo";
 export * from "./filename-from-string.vo";
-export * from "./filename-suffix.vo";
 export * from "./height.vo";
 export * from "./height-milimiters.vo";
 export * from "./hour.vo";

package/dist/index.js

@@ -24,8 +24,8 @@ 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-affix.vo";
 export * from "./filename-from-string.vo";
-export * from "./filename-suffix.vo";
 export * from "./height.vo";
 export * from "./height-milimiters.vo";
 export * from "./hour.vo";

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/age-years.vo.ts","../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock-format.service.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.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/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.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/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/quarter-iso-id.vo.ts","../src/quarter.vo.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding.adapter.ts","../src/rounding.port.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/stopwatch.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.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/weekday.vo.ts","../src/weight-grams.vo.ts","../src/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}
+{"root":["../src/age-years.vo.ts","../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock-format.service.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.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/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.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-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/quarter-iso-id.vo.ts","../src/quarter.vo.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding.adapter.ts","../src/rounding.port.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/stopwatch.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.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/weekday.vo.ts","../src/weight-grams.vo.ts","../src/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",

package/readme.md

@@ -49,8 +49,8 @@ src/
 ├── file-path-absolute-schema.vo.ts
 ├── file-path-relative-schema.vo.ts
 ├── file-path.vo.ts
+├── filename-affix.vo.ts
 ├── filename-from-string.vo.ts
-├── filename-suffix.vo.ts
 ├── filename.vo.ts
 ├── height-milimiters.vo.ts
 ├── height.vo.ts

package/src/filename-affix.vo.ts

@@ -0,0 +1,25 @@
+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",
+} as const;
+
+// Letters, digits, underscores, and hyphens allowed
+const FILENAME_AFFIX_WHITELIST = /^[a-zA-Z0-9_-]+$/;
+
+export const FilenameAffix = z
+  .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.vo.ts

@@ -1,7 +1,7 @@
 import { Basename, type BasenameType } from "./basename.vo";
 import { Extension, type ExtensionType } from "./extension.vo";
+import { FilenameAffix, FilenameAffixStrategy, type FilenameAffixType } from "./filename-affix.vo";
 import { FilenameFromString } from "./filename-from-string.vo";
-import { FilenameSuffix, type FilenameSuffixType } from "./filename-suffix.vo";
 
 export class Filename {
   private constructor(
@@ -43,17 +43,38 @@ export class Filename {
     return new Filename(basename, this.extension);
   }
 
-  withSuffix(candidate: string): Filename {
-    const suffix = FilenameSuffix.parse(candidate);
-    const basename = Basename.parse(`${this.basename}${suffix}`);
+  withAffix(candidate: string, strategy: FilenameAffixStrategy): Filename {
+    const affix = FilenameAffix.parse(candidate);
 
-    return new Filename(basename, this.extension);
+    if (strategy === FilenameAffixStrategy.prefix) {
+      return new Filename(Basename.parse(`${affix}${this.basename}`), this.extension);
+    }
+
+    return new Filename(Basename.parse(`${this.basename}${affix}`), this.extension);
   }
 
-  withSuffixSafe(suffix: FilenameSuffixType): Filename {
-    const basename = Basename.parse(`${this.basename}${suffix}`);
+  withAffixSafe(affix: FilenameAffixType, strategy: FilenameAffixStrategy): Filename {
+    if (strategy === FilenameAffixStrategy.prefix) {
+      return new Filename(Basename.parse(`${affix}${this.basename}`), this.extension);
+    }
 
-    return new Filename(basename, this.extension);
+    return new Filename(Basename.parse(`${this.basename}${affix}`), this.extension);
+  }
+
+  withSuffix(candidate: string) {
+    return this.withAffix(candidate, FilenameAffixStrategy.suffix);
+  }
+
+  withSuffixSafe(affix: FilenameAffixType): Filename {
+    return this.withAffix(affix, FilenameAffixStrategy.suffix);
+  }
+
+  withPrefix(candidate: string) {
+    return this.withAffix(candidate, FilenameAffixStrategy.prefix);
+  }
+
+  withPrefixSafe(affix: FilenameAffixType): Filename {
+    return this.withAffix(affix, FilenameAffixStrategy.prefix);
   }
 
   toString(): string {

package/src/index.ts

@@ -24,8 +24,8 @@ 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-affix.vo";
 export * from "./filename-from-string.vo";
-export * from "./filename-suffix.vo";
 export * from "./height.vo";
 export * from "./height-milimiters.vo";
 export * from "./hour.vo";

package/dist/filename-suffix.vo.d.ts

@@ -1,9 +0,0 @@
-import { z } from "zod/v4";
-export declare const FilenameSuffixError: {
-    readonly Type: "suffix.type";
-    readonly Empty: "suffix.empty";
-    readonly TooLong: "suffix.too.long";
-    readonly BadChars: "suffix.bad.chars";
-};
-export declare const FilenameSuffix: z.core.$ZodBranded<z.ZodString, "FilenameSuffix">;
-export type FilenameSuffixType = z.infer<typeof FilenameSuffix>;

package/dist/filename-suffix.vo.js

@@ -1,15 +0,0 @@
-import { z } from "zod/v4";
-export const FilenameSuffixError = {
-    Type: "suffix.type",
-    Empty: "suffix.empty",
-    TooLong: "suffix.too.long",
-    BadChars: "suffix.bad.chars",
-};
-// Letters, digits, underscores, and hyphens allowed
-const FILENAME_SUFFIX_WHITELIST = /^[a-zA-Z0-9_-]+$/;
-export const FilenameSuffix = z
-    .string(FilenameSuffixError.Type)
-    .min(1, FilenameSuffixError.Empty)
-    .max(32, FilenameSuffixError.TooLong)
-    .regex(FILENAME_SUFFIX_WHITELIST, FilenameSuffixError.BadChars)
-    .brand("FilenameSuffix");

package/src/filename-suffix.vo.ts

@@ -1,20 +0,0 @@
-import { z } from "zod/v4";
-
-export const FilenameSuffixError = {
-  Type: "suffix.type",
-  Empty: "suffix.empty",
-  TooLong: "suffix.too.long",
-  BadChars: "suffix.bad.chars",
-} as const;
-
-// Letters, digits, underscores, and hyphens allowed
-const FILENAME_SUFFIX_WHITELIST = /^[a-zA-Z0-9_-]+$/;
-
-export const FilenameSuffix = z
-  .string(FilenameSuffixError.Type)
-  .min(1, FilenameSuffixError.Empty)
-  .max(32, FilenameSuffixError.TooLong)
-  .regex(FILENAME_SUFFIX_WHITELIST, FilenameSuffixError.BadChars)
-  .brand("FilenameSuffix");
-
-export type FilenameSuffixType = z.infer<typeof FilenameSuffix>;