@breadstone-infrastructure/prisma-seeds 0.0.231

package/utils/EntityLookupCache.js

@@ -0,0 +1,64 @@
+// #region Imports
+/**
+ * Provides a caching layer for expensive lookup operations in JSON seed mappers.
+ *
+ * @public
+ */
+export class EntityLookupCache {
+    // #region Fields
+    cache;
+    resolver;
+    // #endregion
+    // #region Ctor
+    constructor(resolver) {
+        this.cache = new Map();
+        this.resolver = resolver;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Resolves a value for the provided key, using the cache when available.
+     *
+     * @param key Lookup key
+     * @param context Seeder execution context
+     * @returns Resolved value
+     */
+    async resolve(key, context) {
+        const normalizedKey = EntityLookupCache.normalizeKey(key);
+        const cachedValue = this.cache.get(normalizedKey);
+        if (cachedValue !== undefined) {
+            return cachedValue;
+        }
+        const resolvedValue = await this.resolver.resolve(normalizedKey, context);
+        this.cache.set(normalizedKey, resolvedValue);
+        return resolvedValue;
+    }
+    /**
+     * Resolves multiple keys sequentially, preserving order.
+     *
+     * @param keys Lookup keys
+     * @param context Seeder execution context
+     * @returns Resolved values
+     */
+    async resolveMany(keys, context) {
+        const results = [];
+        for (const key of keys) {
+            results.push(await this.resolve(key, context));
+        }
+        return results;
+    }
+    /**
+     * Clears the internal cache.
+     */
+    clear() {
+        this.cache.clear();
+    }
+    static normalizeKey(key) {
+        const normalized = key.trim();
+        if (normalized.length === 0) {
+            throw new Error('Entity key must not be empty.');
+        }
+        return normalized;
+    }
+}
+//# sourceMappingURL=EntityLookupCache.js.map

package/utils/EntityLookupCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLookupCache.js","sourceRoot":"","sources":["../../src/utils/EntityLookupCache.ts"],"names":[],"mappings":"AAAA,kBAAkB;AA2BlB;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAE1B,iBAAiB;IAEA,KAAK,CAAuB;IAC5B,QAAQ,CAAiC;IAE1D,aAAa;IAEb,eAAe;IAEf,YAAmB,QAAwC;QACvD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,OAAqB;QACnD,MAAM,aAAa,GAAW,iBAAiB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAClE,MAAM,WAAW,GAAwB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC;QACvB,CAAC;QAED,MAAM,aAAa,GAAY,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC7C,OAAO,aAAa,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,WAAW,CAAC,IAAuB,EAAE,OAAqB;QACnE,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,GAAW;QACnC,MAAM,UAAU,GAAW,GAAG,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;CAIJ"}

package/utils/ISeedRandom.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Random data generator for seeding operations.
+ *
+ * @public
+ */
+export interface ISeedRandom {
+    /**
+     * Generate a random number, optionally within a specified range.
+     *
+     * @param min The minimum value (inclusive).
+     * @param max The maximum value (exclusive).
+     * @returns A random number.
+     */
+    number(min?: number, max?: number): number;
+    /**
+     * Generate a random integer, optionally within a specified range.
+     *
+     * @param min The minimum value (inclusive).
+     * @param max The maximum value (inclusive).
+     * @returns A random integer.
+     */
+    int(min?: number, max?: number): number;
+    /**
+     * Generate a random boolean value, optionally with a specified probability.
+     *
+     * @param probability The probability of returning true (between 0 and 1).
+     * @returns A random boolean value.
+     */
+    boolean(probability?: number): boolean;
+    /**
+     * Select one or more random items from an array.
+     *
+     * @template T The type of items in the array.
+     * @param items The array of items to choose from.
+     * @returns A single random item or an array of random items.
+     */
+    choice<T>(items: T[]): T;
+    /**
+     * Select multiple random items from an array.
+     *
+     * @template T The type of items in the array.
+     * @param items The array of items to choose from.
+     * @param count The number of items to select.
+     * @returns An array of random items.
+     */
+    choices<T>(items: T[], count: number): T[];
+    /**
+     * Shuffle the items in an array randomly.
+     *
+     * @template T The type of items in the array.
+     * @param items The array of items to shuffle.
+     * @returns A new array with the items shuffled.
+     */
+    shuffle<T>(items: T[]): T[];
+    /**
+     * Generate a random UUID (version 4).
+     *
+     * @returns A random UUID string.
+     */
+    uuid(): string;
+    /**
+     * Generate a random CUID (collision-resistant unique identifier).
+     *
+     * @param prefix An optional prefix to prepend to the CUID.
+     * @param postfix An optional postfix to append to the CUID.
+     * @returns A random CUID string.
+     */
+    cuid(prefix?: string, postfix?: string): string;
+}
+//# sourceMappingURL=ISeedRandom.d.ts.map

package/utils/ISeedRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISeedRandom.d.ts","sourceRoot":"","sources":["../../src/utils/ISeedRandom.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAIxB;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE3C;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExC;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAEzB;;;;;;;OAOG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;IAE3C;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAE5B;;;;OAIG;IACH,IAAI,IAAI,MAAM,CAAC;IAEf;;;;;;OAMG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAInD"}

package/utils/ISeedRandom.js

@@ -0,0 +1,3 @@
+/* eslint-disable no-unused-vars */
+export {};
+//# sourceMappingURL=ISeedRandom.js.map

package/utils/ISeedRandom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISeedRandom.js","sourceRoot":"","sources":["../../src/utils/ISeedRandom.ts"],"names":[],"mappings":"AAAA,mCAAmC"}

package/utils/LocalizationToolkit.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Represents a dictionary of localized values keyed by locale identifier.
+ *
+ * @public
+ */
+export interface ITranslationMap {
+    [locale: string]: unknown;
+}
+/**
+ * Normalized translation value containing locale and trimmed text.
+ *
+ * @public
+ */
+export interface ITranslationValue {
+    /**
+     * Locale identifier (e.g. `en`, `de`).
+     */
+    readonly locale: string;
+    /**
+     * Trimmed translation text.
+     */
+    readonly value: string;
+}
+/**
+ * Options for validating translation maps.
+ *
+ * @public
+ */
+export interface ITranslationValidationOptions {
+    /**
+     * Human readable field name for error messaging.
+     */
+    readonly fieldName: string;
+    /**
+     * Preferred locales when resolving primary translation values.
+     */
+    readonly fallbackLocales?: readonly string[];
+}
+/**
+ * Prisma payload for creating translation group values.
+ *
+ * @public
+ */
+export interface ITranslationGroupCreatePayload {
+    readonly create: {
+        readonly values: {
+            readonly createMany: {
+                readonly data: readonly ITranslationValue[];
+            };
+        };
+    };
+}
+/**
+ * Prisma payload for updating translation group values.
+ *
+ * @public
+ */
+export interface ITranslationGroupUpdatePayload {
+    readonly update: {
+        readonly values: {
+            readonly deleteMany: Record<string, never>;
+            readonly createMany: {
+                readonly data: readonly ITranslationValue[];
+            };
+        };
+    };
+}
+/**
+ * Provides translation related utilities for JSON seed mappers.
+ *
+ * @public
+ */
+export declare class LocalizationToolkit {
+    private static readonly DEFAULT_FALLBACK_LOCALES;
+    private constructor();
+    /**
+     * Normalizes a translation map into Prisma compatible value objects.
+     *
+     * @param translations Translation dictionary
+     * @returns Normalized translation values
+     */
+    static mapValues(translations: ITranslationMap | null | undefined): ITranslationValue[];
+    /**
+     * Ensures that the provided translations contain at least one valid entry.
+     *
+     * @param translations Translation dictionary
+     * @param options Validation options
+     * @returns Normalized translation values
+     */
+    static ensureValues(translations: ITranslationMap | null | undefined, options: ITranslationValidationOptions): ITranslationValue[];
+    /**
+     * Creates a Prisma payload for translation group creation.
+     *
+     * @param translations Translation dictionary
+     * @param options Validation options
+     * @returns Prisma payload for create operation
+     */
+    static createGroup(translations: ITranslationMap | null | undefined, options: ITranslationValidationOptions): ITranslationGroupCreatePayload;
+    /**
+     * Creates a Prisma payload for translation group updates.
+     *
+     * @param translations Translation dictionary
+     * @param options Validation options
+     * @returns Prisma payload for update operation
+     */
+    static updateGroup(translations: ITranslationMap | null | undefined, options: ITranslationValidationOptions): ITranslationGroupUpdatePayload;
+    /**
+     * Chooses between creating or updating a translation group based on existing data presence.
+     *
+     * @param translations Translation dictionary
+     * @param hasExistingGroup Whether a translation group already exists
+     * @param options Validation options
+     * @returns Prisma payload for create or update
+     */
+    static createOrUpdateGroup(translations: ITranslationMap | null | undefined, hasExistingGroup: boolean, options: ITranslationValidationOptions): ITranslationGroupCreatePayload | ITranslationGroupUpdatePayload;
+    /**
+     * Resolves the primary textual representation from a translation map.
+     *
+     * @param translations Translation dictionary
+     * @param fallbackLocales Preferred locales used for selection (defaults to `['en']`)
+     * @returns Primary text or empty string when not available
+     */
+    static resolvePrimary(translations: ITranslationMap | null | undefined, fallbackLocales?: readonly string[]): string;
+}
+//# sourceMappingURL=LocalizationToolkit.d.ts.map

package/utils/LocalizationToolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationToolkit.d.ts","sourceRoot":"","sources":["../../src/utils/LocalizationToolkit.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAI5B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAI7B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAI9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAI1B;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAI1C;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAIhD;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAI3C,QAAQ,CAAC,MAAM,EAAE;QACb,QAAQ,CAAC,MAAM,EAAE;YACb,QAAQ,CAAC,UAAU,EAAE;gBACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;aAC/C,CAAC;SACL,CAAC;KACL,CAAC;CAIL;AAED;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAI3C,QAAQ,CAAC,MAAM,EAAE;QACb,QAAQ,CAAC,MAAM,EAAE;YACb,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,QAAQ,CAAC,UAAU,EAAE;gBACjB,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;aAC/C,CAAC;SACL,CAAC;KACL,CAAC;CAIL;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;IAM7E,OAAO;IAQP;;;;;OAKG;WACW,SAAS,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,EAAE;IAyB9F;;;;;;OAMG;WACW,YAAY,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,6BAA6B,GAAG,iBAAiB,EAAE;IASzI;;;;;;OAMG;WACW,WAAW,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,6BAA6B,GAAG,8BAA8B;IAanJ;;;;;;OAMG;WACW,WAAW,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,6BAA6B,GAAG,8BAA8B;IAcnJ;;;;;;;OAOG;WACW,mBAAmB,CAC7B,YAAY,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAChD,gBAAgB,EAAE,OAAO,EACzB,OAAO,EAAE,6BAA6B,GACvC,8BAA8B,GAAG,8BAA8B;IAMlE;;;;;;OAMG;WACW,cAAc,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAAE,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM;CAmB9H"}

package/utils/LocalizationToolkit.js

@@ -0,0 +1,131 @@
+// #region Imports
+/**
+ * Provides translation related utilities for JSON seed mappers.
+ *
+ * @public
+ */
+export class LocalizationToolkit {
+    // #region Fields
+    static DEFAULT_FALLBACK_LOCALES = ['en'];
+    // #endregion
+    // #region Ctor
+    constructor() {
+        // Utility class
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Normalizes a translation map into Prisma compatible value objects.
+     *
+     * @param translations Translation dictionary
+     * @returns Normalized translation values
+     */
+    static mapValues(translations) {
+        if (!translations) {
+            return [];
+        }
+        const normalizedValues = [];
+        for (const [locale, rawValue] of Object.entries(translations)) {
+            if (typeof rawValue !== 'string') {
+                continue;
+            }
+            const trimmedValue = rawValue.trim();
+            if (trimmedValue.length === 0) {
+                continue;
+            }
+            normalizedValues.push({
+                locale,
+                value: trimmedValue
+            });
+        }
+        return normalizedValues;
+    }
+    /**
+     * Ensures that the provided translations contain at least one valid entry.
+     *
+     * @param translations Translation dictionary
+     * @param options Validation options
+     * @returns Normalized translation values
+     */
+    static ensureValues(translations, options) {
+        const normalizedValues = LocalizationToolkit.mapValues(translations);
+        if (normalizedValues.length === 0) {
+            throw new Error(`${options.fieldName} requires at least one translation.`);
+        }
+        return normalizedValues;
+    }
+    /**
+     * Creates a Prisma payload for translation group creation.
+     *
+     * @param translations Translation dictionary
+     * @param options Validation options
+     * @returns Prisma payload for create operation
+     */
+    static createGroup(translations, options) {
+        const normalizedValues = LocalizationToolkit.ensureValues(translations, options);
+        return {
+            create: {
+                values: {
+                    createMany: {
+                        data: normalizedValues
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * Creates a Prisma payload for translation group updates.
+     *
+     * @param translations Translation dictionary
+     * @param options Validation options
+     * @returns Prisma payload for update operation
+     */
+    static updateGroup(translations, options) {
+        const normalizedValues = LocalizationToolkit.ensureValues(translations, options);
+        return {
+            update: {
+                values: {
+                    deleteMany: {},
+                    createMany: {
+                        data: normalizedValues
+                    }
+                }
+            }
+        };
+    }
+    /**
+     * Chooses between creating or updating a translation group based on existing data presence.
+     *
+     * @param translations Translation dictionary
+     * @param hasExistingGroup Whether a translation group already exists
+     * @param options Validation options
+     * @returns Prisma payload for create or update
+     */
+    static createOrUpdateGroup(translations, hasExistingGroup, options) {
+        return hasExistingGroup
+            ? LocalizationToolkit.updateGroup(translations, options)
+            : LocalizationToolkit.createGroup(translations, options);
+    }
+    /**
+     * Resolves the primary textual representation from a translation map.
+     *
+     * @param translations Translation dictionary
+     * @param fallbackLocales Preferred locales used for selection (defaults to `['en']`)
+     * @returns Primary text or empty string when not available
+     */
+    static resolvePrimary(translations, fallbackLocales) {
+        const normalizedValues = LocalizationToolkit.mapValues(translations);
+        if (normalizedValues.length === 0) {
+            return '';
+        }
+        const preferredLocales = fallbackLocales ?? LocalizationToolkit.DEFAULT_FALLBACK_LOCALES;
+        for (const locale of preferredLocales) {
+            const match = normalizedValues.find((value) => value.locale === locale);
+            if (match) {
+                return match.value;
+            }
+        }
+        return normalizedValues[0]?.value ?? '';
+    }
+}
+//# sourceMappingURL=LocalizationToolkit.js.map

package/utils/LocalizationToolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalizationToolkit.js","sourceRoot":"","sources":["../../src/utils/LocalizationToolkit.ts"],"names":[],"mappings":"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"}

package/utils/SeededRandom.d.ts

@@ -0,0 +1,15 @@
+import type { ISeedRandom } from './ISeedRandom.js';
+export declare class SeededRandom implements ISeedRandom {
+    private _seed;
+    private _cuidIncrement;
+    constructor(seed?: number);
+    number(min?: number, max?: number): number;
+    int(min?: number, max?: number): number;
+    boolean(probability?: number): boolean;
+    choice<T>(items: T[]): T;
+    choices<T>(items: T[], count: number): T[];
+    shuffle<T>(items: T[]): T[];
+    uuid(): string;
+    cuid(prefix?: string, postfix?: string): string;
+}
+//# sourceMappingURL=SeededRandom.d.ts.map

package/utils/SeededRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeededRandom.d.ts","sourceRoot":"","sources":["../../src/utils/SeededRandom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,qBAAa,YAAa,YAAW,WAAW;IAE5C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAS;gBAEZ,IAAI,CAAC,EAAE,MAAM;IAKzB,MAAM,CAAC,GAAG,SAAI,EAAE,GAAG,SAAI,GAAG,MAAM;IAMhC,GAAG,CAAC,GAAG,SAAI,EAAE,GAAG,SAAM,GAAG,MAAM;IAI/B,OAAO,CAAC,WAAW,SAAM,GAAG,OAAO;IAInC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC;IAQxB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;IAQ1C,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAS3B,IAAI,IAAI,MAAM;IAId,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;CAUzD"}

package/utils/SeededRandom.js

@@ -0,0 +1,56 @@
+// #region Imports
+import { randomUUID } from 'node:crypto';
+// #endregion
+export class SeededRandom {
+    _seed;
+    _cuidIncrement;
+    constructor(seed) {
+        this._seed = seed ?? Date.now();
+        this._cuidIncrement = 0;
+    }
+    number(min = 0, max = 1) {
+        this._seed = ((this._seed * 9301) + 49297) % 233280;
+        const rnd = this._seed / 233280.0;
+        return min + (rnd * (max - min));
+    }
+    int(min = 0, max = 100) {
+        return Math.floor(this.number(min, max + 1));
+    }
+    boolean(probability = 0.5) {
+        return this.number() < probability;
+    }
+    choice(items) {
+        if (items.length === 0) {
+            throw new Error('Cannot choose from empty array');
+        }
+        const index = this.int(0, items.length - 1);
+        return items[index];
+    }
+    choices(items, count) {
+        const result = [];
+        for (let i = 0; i < count; i++) {
+            result.push(this.choice(items));
+        }
+        return result;
+    }
+    shuffle(items) {
+        const result = [...items];
+        for (let i = result.length - 1; i > 0; i--) {
+            const j = this.int(0, i);
+            [result[i], result[j]] = [result[j], result[i]];
+        }
+        return result;
+    }
+    uuid() {
+        return randomUUID();
+    }
+    cuid(prefix, postfix) {
+        const timestamp = Date.now().toString(36);
+        const randomBlock = Math.random().toString(36)
+            .substring(2, 10);
+        const counterBlock = (this._cuidIncrement++).toString(36).padStart(4, '0');
+        const cuid = `c${timestamp}${counterBlock}${randomBlock}`;
+        return `${prefix ?? ''}${cuid}${postfix ?? ''}`;
+    }
+}
+//# sourceMappingURL=SeededRandom.js.map

package/utils/SeededRandom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeededRandom.js","sourceRoot":"","sources":["../../src/utils/SeededRandom.ts"],"names":[],"mappings":"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"}

package/utils/StringArrayToolkit.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Provides utilities for working with arrays of string values in seed configurations.
+ *
+ * @public
+ */
+export declare class StringArrayToolkit {
+    private static readonly EMPTY_RESULT;
+    private constructor();
+    /**
+     * Normalizes an arbitrary array to a deduplicated list of trimmed strings.
+     *
+     * @param values Arbitrary values
+     * @returns Deduplicated and trimmed string list
+     */
+    static unique(values: unknown[] | null | undefined): readonly string[];
+    /**
+     * Ensures that at least one valid string value is present.
+     *
+     * @param values Arbitrary values
+     * @param errorMessage Error to throw when no valid strings are found
+     * @returns Deduplicated and trimmed string list
+     */
+    static ensureNonEmpty(values: unknown[] | null | undefined, errorMessage: string): readonly string[];
+}
+//# sourceMappingURL=StringArrayToolkit.d.ts.map

package/utils/StringArrayToolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringArrayToolkit.d.ts","sourceRoot":"","sources":["../../src/utils/StringArrayToolkit.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAyB;IAM7D,OAAO;IAQP;;;;;OAKG;WACW,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE;IAsB7E;;;;;;OAMG;WACW,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;CAW9G"}

package/utils/StringArrayToolkit.js

@@ -0,0 +1,56 @@
+// #region Imports
+// #endregion
+/**
+ * Provides utilities for working with arrays of string values in seed configurations.
+ *
+ * @public
+ */
+export class StringArrayToolkit {
+    // #region Fields
+    static EMPTY_RESULT = [];
+    // #endregion
+    // #region Ctor
+    constructor() {
+        // Utility class
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Normalizes an arbitrary array to a deduplicated list of trimmed strings.
+     *
+     * @param values Arbitrary values
+     * @returns Deduplicated and trimmed string list
+     */
+    static unique(values) {
+        if (!values || values.length === 0) {
+            return StringArrayToolkit.EMPTY_RESULT;
+        }
+        const normalizedValues = new Set();
+        for (const value of values) {
+            if (typeof value !== 'string') {
+                continue;
+            }
+            const trimmedValue = value.trim();
+            if (trimmedValue.length === 0) {
+                continue;
+            }
+            normalizedValues.add(trimmedValue);
+        }
+        return Array.from(normalizedValues);
+    }
+    /**
+     * Ensures that at least one valid string value is present.
+     *
+     * @param values Arbitrary values
+     * @param errorMessage Error to throw when no valid strings are found
+     * @returns Deduplicated and trimmed string list
+     */
+    static ensureNonEmpty(values, errorMessage) {
+        const normalizedValues = StringArrayToolkit.unique(values);
+        if (normalizedValues.length === 0) {
+            throw new Error(errorMessage);
+        }
+        return normalizedValues;
+    }
+}
+//# sourceMappingURL=StringArrayToolkit.js.map

package/utils/StringArrayToolkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringArrayToolkit.js","sourceRoot":"","sources":["../../src/utils/StringArrayToolkit.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,aAAa;AAEb;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAE3B,iBAAiB;IAET,MAAM,CAAU,YAAY,GAAsB,EAAE,CAAC;IAE7D,aAAa;IAEb,eAAe;IAEf;QACI,gBAAgB;IACpB,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;OAKG;IACI,MAAM,CAAC,MAAM,CAAC,MAAoC;QACrD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,kBAAkB,CAAC,YAAY,CAAC;QAC3C,CAAC;QAED,MAAM,gBAAgB,GAAgB,IAAI,GAAG,EAAU,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,SAAS;YACb,CAAC;YAED,MAAM,YAAY,GAAW,KAAK,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACb,CAAC;YAED,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,cAAc,CAAC,MAAoC,EAAE,YAAoB;QACnF,MAAM,gBAAgB,GAAsB,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9E,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC5B,CAAC"}

package/utils/StringValueGuard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Provides validation utilities for working with string values inside seed mappers.
+ *
+ * @public
+ */
+export declare class StringValueGuard {
+    private constructor();
+    /**
+     * Ensures that the provided value is a non-empty string.
+     *
+     * @param value Value to validate
+     * @param errorMessage Error message when validation fails
+     * @returns Trimmed string value
+     */
+    static ensure(value: unknown, errorMessage: string): string;
+    /**
+     * Normalizes optional string inputs by trimming whitespace.
+     *
+     * @param value Value to normalize
+     * @returns Trimmed string or null when empty
+     */
+    static normalize(value: unknown): string | null;
+}
+//# sourceMappingURL=StringValueGuard.d.ts.map

package/utils/StringValueGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringValueGuard.d.ts","sourceRoot":"","sources":["../../src/utils/StringValueGuard.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,qBAAa,gBAAgB;IAIzB,OAAO;IAQP;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAalE;;;;;OAKG;WACW,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;CAWzD"}

package/utils/StringValueGuard.js

@@ -0,0 +1,46 @@
+// #region Imports
+// #endregion
+/**
+ * Provides validation utilities for working with string values inside seed mappers.
+ *
+ * @public
+ */
+export class StringValueGuard {
+    // #region Ctor
+    constructor() {
+        // Static utility
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Ensures that the provided value is a non-empty string.
+     *
+     * @param value Value to validate
+     * @param errorMessage Error message when validation fails
+     * @returns Trimmed string value
+     */
+    static ensure(value, errorMessage) {
+        if (typeof value !== 'string') {
+            throw new Error(errorMessage);
+        }
+        const trimmedValue = value.trim();
+        if (trimmedValue.length === 0) {
+            throw new Error(errorMessage);
+        }
+        return trimmedValue;
+    }
+    /**
+     * Normalizes optional string inputs by trimming whitespace.
+     *
+     * @param value Value to normalize
+     * @returns Trimmed string or null when empty
+     */
+    static normalize(value) {
+        if (typeof value !== 'string') {
+            return null;
+        }
+        const trimmedValue = value.trim();
+        return trimmedValue.length > 0 ? trimmedValue : null;
+    }
+}
+//# sourceMappingURL=StringValueGuard.js.map