@breadstone-infrastructure/prisma-seeds 0.0.231

package/orchestration/SeedOrchestrator.js

@@ -0,0 +1,262 @@
+// #region Imports
+import { createAdapter } from '../config/createAdapter.js';
+import { SeedConfigDiscovery } from '../discovery/SeedConfigDiscovery.js';
+import { SeedLogger } from '../logging/SeedLogger.js';
+import { SeededRandom } from '../utils/SeededRandom.js';
+export class SeedOrchestrator {
+    // #region Fields
+    _discovery;
+    _logger;
+    // #endregion
+    // #region Ctor
+    constructor() {
+        this._discovery = new SeedConfigDiscovery();
+        // Logger will be created with proper logLevel in execute method
+        this._logger = new SeedLogger();
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * @description Discovers seed configs and merges runtime options.
+     * Config file `options` are the defaults, NX executor overrides take priority.
+     * This follows the Vite pattern: config file is primary, executor options override.
+     */
+    async executeWithOverrides(rootPath, overrides) {
+        const composedConfig = await this._discovery.discover({
+            rootPath,
+            searchPaths: ['libs/**', 'apps/**'],
+        });
+        const configOptions = composedConfig.rootConfig.options ?? {};
+        const merged = {
+            drop: overrides.drop ?? configOptions.drop,
+            count: overrides.count ?? configOptions.count,
+            force: overrides.force ?? configOptions.force,
+            dryRun: overrides.dryRun ?? configOptions.dryRun,
+            seed: overrides.seed ?? configOptions.seed,
+            environment: overrides.environment ?? configOptions.environment,
+        };
+        return this._executeWithComposedConfig(composedConfig, merged);
+    }
+    /**
+     * @description Runs seeding with explicit options (no config file merging).
+     */
+    async execute(rootPath, options) {
+        const composedConfig = await this._discovery.discover({
+            rootPath,
+            searchPaths: ['libs/**', 'apps/**'],
+        });
+        return this._executeWithComposedConfig(composedConfig, options);
+    }
+    async _executeWithComposedConfig(composedConfig, options) {
+        const startTime = Date.now();
+        try {
+            // Create logger with logLevel from composed config
+            const logLevel = composedConfig.resolved.logLevel;
+            this._logger = new SeedLogger(logLevel);
+            this._logger.info('🌱 Starting seed orchestration...');
+            this._logger.info(`Found ${composedConfig.featureConfigs.length} feature configs`);
+            this._logger.info(`Execution order: ${composedConfig.resolved.executionOrder.join(' → ')}`);
+            // Initialize shared context
+            const context = await this.createContext(composedConfig, options);
+            // Execute seeds in order
+            const seedResults = [];
+            let totalItemsCreated = 0;
+            for (const seedDef of composedConfig.resolved.seeds) {
+                if (seedDef.enabled === false) {
+                    continue;
+                }
+                // Clear warnings for each new seed
+                context.warnings?.clear();
+                this._logger.startGroup(`Executing: ${seedDef.name}`);
+                try {
+                    const seeder = seedDef.factory.create();
+                    const seedContext = {
+                        ...context,
+                        seedConfigPath: seedDef.configPath ?? context.seedConfigPath
+                    };
+                    const result = await seeder.seed(seedContext);
+                    seedResults.push({
+                        name: seedDef.name,
+                        result
+                    });
+                    totalItemsCreated += result.itemsCreated;
+                    if (result.success) {
+                        this._logger.success(`${result.itemsCreated} items in ${result.duration}ms`);
+                    }
+                    else {
+                        this._logger.error(`Failed with ${result.errors.length} errors`);
+                        for (const error of result.errors) {
+                            this._logger.error(error);
+                        }
+                    }
+                    for (const warning of result.warnings) {
+                        this._logger.warn(warning);
+                    }
+                }
+                catch (error) {
+                    const errorMsg = `Seed threw exception: ${error}` + (error instanceof Error && error.stack ? `\n${error.stack}` : '');
+                    this._logger.error(errorMsg);
+                    seedResults.push({
+                        name: seedDef.name,
+                        result: {
+                            success: false,
+                            itemsCreated: 0,
+                            duration: 0,
+                            errors: [errorMsg],
+                            warnings: []
+                        }
+                    });
+                }
+                finally {
+                    this._logger.endGroup();
+                }
+            }
+            const totalDuration = Date.now() - startTime;
+            const allSuccessful = seedResults.every((sr) => sr.result.success);
+            const allErrors = seedResults.flatMap((sr) => sr.result.errors);
+            if (allSuccessful) {
+                this._logger.info('🎉 Seeding completed successfully!');
+                this._logger.info(`📈 Total items created: ${totalItemsCreated}`);
+                this._logger.info(`⏱️  Total duration: ${totalDuration}ms`);
+            }
+            else {
+                this._logger.error('💥 Seeding completed with errors!');
+            }
+            return {
+                success: allSuccessful,
+                totalItemsCreated: totalItemsCreated,
+                totalDuration: totalDuration,
+                seedResults: seedResults,
+                errors: allErrors
+            };
+        }
+        catch (error) {
+            const errorMsg = `Fatal error during seeding: ${error}`;
+            this._logger.error(errorMsg);
+            return {
+                success: false,
+                totalItemsCreated: 0,
+                totalDuration: Date.now() - startTime,
+                seedResults: [],
+                errors: [errorMsg]
+            };
+        }
+    }
+    async createContext(composedConfig, options) {
+        // Import PrismaClient dynamically to avoid compile-time dependency
+        const { PrismaClient } = await import('@prisma/client');
+        const prisma = new PrismaClient();
+        // Handle drop option
+        if (options.drop) {
+            this._logger.info('🗑️ Dropping existing data...');
+            // Note: Individual seeders should handle their own cleanup
+        }
+        // Import AssetManager for asset handling
+        const { AssetManager } = await import('../assets/AssetManager.js');
+        // Check if any seed configuration has asset configuration
+        const firstAssetConfig = composedConfig.featureConfigs.find((config) => config.assets)?.assets;
+        // Create a default blob adapter (will be overridden per feature if needed)
+        const defaultBlobAdapter = createAdapter('empty');
+        // Create AssetManager with default adapter (will be reconfigured per feature)
+        const assetManager = new AssetManager(this._logger, {
+            assetsDir: firstAssetConfig?.assetsDir || '.seed/assets',
+            uploadToBlob: firstAssetConfig?.uploadToBlob ?? !options.dryRun,
+            blobAdapter: defaultBlobAdapter,
+            imageTransforms: firstAssetConfig?.imageTransforms
+        });
+        // Import EntityResolver, LocalizationToolkit, and WarningCollector for factory methods
+        const { EntityResolver } = await import('../resolvers/EntityResolver.js');
+        const { LocalizationToolkit } = await import('../utils/LocalizationToolkit.js');
+        const { WarningCollector } = await import('../utils/WarningCollector.js');
+        // Create warning collector
+        const warningCollector = new WarningCollector(this._logger);
+        // Create complete context with factory methods
+        const context = {
+            prisma,
+            options,
+            logger: this._logger,
+            random: new SeededRandom(options.seed),
+            assets: assetManager,
+            seedConfigPath: undefined,
+            warnings: warningCollector,
+            // Factory method for creating cached entity resolvers
+            entity(modelName, uniqueField) {
+                return new EntityResolver(modelName, uniqueField, ['id'], // Default: only select 'id' field
+                context);
+            },
+            // Alias for batch resolution (same implementation)
+            manyEntity(modelName, uniqueField) {
+                return new EntityResolver(modelName, uniqueField, ['id'], context);
+            },
+            // Localization helpers namespace (direct passthrough to LocalizationToolkit)
+            localize: {
+                resolvePrimary: LocalizationToolkit.resolvePrimary.bind(LocalizationToolkit),
+                mapValues: LocalizationToolkit.mapValues.bind(LocalizationToolkit),
+                createGroup: LocalizationToolkit.createGroup.bind(LocalizationToolkit),
+                updateGroup: LocalizationToolkit.updateGroup.bind(LocalizationToolkit),
+                createOrUpdateGroup: LocalizationToolkit.createOrUpdateGroup.bind(LocalizationToolkit)
+            }
+        };
+        // Process assets for each feature that has them
+        const featuresWithAssets = composedConfig.featureConfigs.filter((config) => config.assets?.files && config.configPath);
+        if (featuresWithAssets.length > 0) {
+            this._logger.info('🖼️  Processing configured assets...');
+            for (const featureConfig of featuresWithAssets) {
+                if (!featureConfig.assets || !featureConfig.configPath || !featureConfig.assets.files) {
+                    continue;
+                }
+                const assetConfig = featureConfig.assets;
+                // Create blob adapter for this specific feature
+                let blobAdapter = createAdapter('empty');
+                if (assetConfig.blobAdapter) {
+                    const adapterType = assetConfig.blobAdapter.type;
+                    if (adapterType === 'empty') {
+                        blobAdapter = createAdapter('empty');
+                    }
+                    else if (adapterType === 'local' && assetConfig.blobAdapter.config) {
+                        blobAdapter = createAdapter('local', {
+                            keyPrefix: assetConfig.blobAdapter.config.keyPrefix,
+                            baseDirectory: assetConfig.blobAdapter.config.baseDirectory || './uploads',
+                            baseUrl: assetConfig.blobAdapter.config.baseUrl || 'http://localhost:3000/uploads'
+                        });
+                    }
+                    else if (adapterType === 'vercel' && assetConfig.blobAdapter.config) {
+                        const token = assetConfig.blobAdapter.config.token;
+                        if (token) {
+                            blobAdapter = createAdapter('vercel', {
+                                token: token,
+                                keyPrefix: assetConfig.blobAdapter.config.keyPrefix,
+                                baseUrl: assetConfig.blobAdapter.config.baseUrl
+                            });
+                        }
+                        else {
+                            this._logger.warn(`Vercel blob adapter configured for ${featureConfig.name} but missing token - using empty adapter`);
+                        }
+                    }
+                    else if (adapterType === 'cloudflare-r2' && assetConfig.blobAdapter.config) {
+                        const { accessKeyId, secretAccessKey, bucketName, accountId } = assetConfig.blobAdapter.config;
+                        if (accessKeyId && secretAccessKey && bucketName && accountId) {
+                            blobAdapter = createAdapter('cloudflare-r2', {
+                                accessKeyId: accessKeyId,
+                                secretAccessKey: secretAccessKey,
+                                bucketName: bucketName,
+                                accountId: accountId,
+                                keyPrefix: assetConfig.blobAdapter.config.keyPrefix,
+                                baseUrl: assetConfig.blobAdapter.config.publicBaseUrl
+                            });
+                        }
+                        else {
+                            this._logger.warn(`Cloudflare R2 blob adapter configured for ${featureConfig.name} but missing required credentials - using empty adapter`);
+                        }
+                    }
+                }
+                // Reconfigure AssetManager with feature-specific adapter
+                assetManager.reconfigureBlobAdapter(blobAdapter);
+                // Process assets for this feature
+                await assetManager.processAssets(featureConfig.configPath, assetConfig.files);
+            }
+        }
+        return context;
+    }
+}
+//# sourceMappingURL=SeedOrchestrator.js.map

package/orchestration/SeedOrchestrator.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+    "name": "@breadstone-infrastructure/prisma-seeds",
+    "description": "Prisma seeds",
+    "version": "0.0.231",
+    "license": "MIT",
+    "author": "andre.wehlert <awehlert@breadstone.de> (https://www.breadstone.de)",
+    "repository": {
+        "url": "git+ssh://git@github.com/RueDeRennes/mosaik.git"
+    },
+    "type": "module",
+    "main": "./index.js",
+    "types": "./index.d.ts",
+    "bin": "./bin/prisma-seeds.js",
+    "dependencies": {
+        "@ai-sdk/openai": "3.0.45",
+        "@breadstone-infrastructure/utilities": "0.0.231",
+        "@nx/vite": "22.5.4",
+        "@prisma/client": "6.19.2",
+        "ai": "6.0.127",
+        "axios": "1.13.6",
+        "glob": "13.0.6",
+        "sharp": "0.34.5",
+        "tslib": "2.8.1",
+        "vitest": "4.1.0",
+        "zod": "4.3.6"
+    }
+}

package/resolvers/EntityResolver.d.ts

@@ -0,0 +1,43 @@
+import type { ISeedContext } from '../config/ISeedContext.js';
+/**
+ * Generic entity resolver with built-in caching.
+ * Resolves entity IDs or full entities from unique keys with automatic cache management.
+ *
+ * @template TKey - Type of the lookup key (usually string)
+ * @template TResult - Type of the resolved result (ID or full entity)
+ *
+ * @example
+ * ```ts
+ * // In seed mapper:
+ * const categoryId = await ctx.entity('exerciseCategory', 'key').resolve(data.categoryKey);
+ * const muscleIds = await ctx.manyEntity('muscleGroup', 'name').resolve(data.muscles);
+ * ```
+ */
+export declare class EntityResolver<TKey = string, TResult = string> {
+    private readonly _cache;
+    private readonly _modelName;
+    private readonly _uniqueField;
+    private readonly _selectFields;
+    private readonly _context;
+    constructor(modelName: string, uniqueField: string, selectFields: string[], context: ISeedContext);
+    /**
+     * Resolve a single entity by key (cached).
+     *
+     * @param key - Unique key to look up
+     * @returns Resolved entity data or throws if not found
+     */
+    resolve(key: TKey): Promise<TResult>;
+    /**
+     * Resolve multiple entities by keys (batched, cached).
+     *
+     * @param keys - Array of unique keys
+     * @returns Array of resolved entity data in same order
+     */
+    resolveMany(keys: TKey[]): Promise<TResult[]>;
+    /**
+     * Clear the internal cache (useful for testing or re-seeding scenarios).
+     */
+    clearCache(): void;
+    private _performLookup;
+}
+//# sourceMappingURL=EntityResolver.d.ts.map

package/resolvers/EntityResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityResolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/EntityResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc,CAAC,IAAI,GAAG,MAAM,EAAE,OAAO,GAAG,MAAM;IAIvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAOpC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,YAAY;IAYzB;;;;;OAKG;IACU,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBjD;;;;;OAKG;IACU,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAQ1D;;OAEG;IACI,UAAU,IAAI,IAAI;YAIX,cAAc;CAqC/B"}

package/resolvers/EntityResolver.js

@@ -0,0 +1,95 @@
+/**
+ * Generic entity resolver with built-in caching.
+ * Resolves entity IDs or full entities from unique keys with automatic cache management.
+ *
+ * @template TKey - Type of the lookup key (usually string)
+ * @template TResult - Type of the resolved result (ID or full entity)
+ *
+ * @example
+ * ```ts
+ * // In seed mapper:
+ * const categoryId = await ctx.entity('exerciseCategory', 'key').resolve(data.categoryKey);
+ * const muscleIds = await ctx.manyEntity('muscleGroup', 'name').resolve(data.muscles);
+ * ```
+ */
+export class EntityResolver {
+    // #region Fields
+    _cache = new Map();
+    _modelName;
+    _uniqueField;
+    _selectFields;
+    _context;
+    // #endregion
+    // #region Ctor
+    constructor(modelName, uniqueField, selectFields, context) {
+        this._modelName = modelName;
+        this._uniqueField = uniqueField;
+        this._selectFields = selectFields;
+        this._context = context;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Resolve a single entity by key (cached).
+     *
+     * @param key - Unique key to look up
+     * @returns Resolved entity data or throws if not found
+     */
+    async resolve(key) {
+        if (!key) {
+            throw new Error(`Cannot resolve ${this._modelName}: key is null or undefined`);
+        }
+        // Return cached promise if available
+        const cached = this._cache.get(key);
+        if (cached) {
+            return cached;
+        }
+        // Create new lookup promise and cache it immediately (prevents duplicate queries)
+        const promise = this._performLookup(key);
+        this._cache.set(key, promise);
+        return promise;
+    }
+    /**
+     * Resolve multiple entities by keys (batched, cached).
+     *
+     * @param keys - Array of unique keys
+     * @returns Array of resolved entity data in same order
+     */
+    async resolveMany(keys) {
+        if (!Array.isArray(keys) || keys.length === 0) {
+            throw new Error(`Cannot resolve ${this._modelName}: keys must be a non-empty array`);
+        }
+        return Promise.all(keys.map((key) => this.resolve(key)));
+    }
+    /**
+     * Clear the internal cache (useful for testing or re-seeding scenarios).
+     */
+    clearCache() {
+        this._cache.clear();
+    }
+    async _performLookup(key) {
+        // Build select projection dynamically
+        const select = this._selectFields.reduce((acc, field) => {
+            acc[field] = true;
+            return acc;
+        }, {});
+        // Access Prisma model dynamically via bracket notation
+        const model = this._context.prisma[this._modelName];
+        if (!model || typeof model.findFirst !== 'function') {
+            throw new Error(`Invalid Prisma model: ${this._modelName}`);
+        }
+        const result = await model.findFirst({
+            where: { [this._uniqueField]: key },
+            select
+        });
+        if (!result) {
+            throw new Error(`${this._modelName} not found with ${this._uniqueField}="${String(key)}"`);
+        }
+        // If only one field selected and it's 'id', return scalar; otherwise return full object
+        if (this._selectFields.length === 1 && this._selectFields[0] === 'id') {
+            return result.id;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=EntityResolver.js.map

package/resolvers/EntityResolver.js.map

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

package/utils/AssetReferenceResolver.d.ts

@@ -0,0 +1,49 @@
+import type { ISeedContext } from '../config/ISeedContext.js';
+/**
+ * Options controlling how asset references are resolved within JSON seeds.
+ *
+ * @public
+ */
+export interface IAssetReferenceOptions {
+    /**
+     * Prefix used to detect asset references.
+     *
+     * @defaultValue "@asset:"
+     */
+    readonly prefix?: string;
+    /**
+     * Whether to trim surrounding whitespace from asset references prior to evaluation.
+     *
+     * @defaultValue true
+     */
+    readonly trim?: boolean;
+}
+/**
+ * Resolves asset references inside JSON seed payloads.
+ *
+ * @public
+ */
+export declare class AssetReferenceResolver {
+    /**
+     * Default prefix that indicates an asset reference.
+     */
+    static readonly DEFAULT_PREFIX: string;
+    private constructor();
+    /**
+     * Resolves a potential asset reference to a concrete asset URL.
+     *
+     * @param value The JSON value that may contain an asset reference
+     * @param context Seeder execution context
+     * @param options Optional resolution configuration
+     * @returns The resolved asset URL or the normalized value when no prefix is present
+     */
+    static resolve(value: unknown, context: ISeedContext, options?: IAssetReferenceOptions): string | null;
+    /**
+     * Creates a reusable resolver function with the provided options.
+     *
+     * @param options Optional resolution options
+     * @returns A resolver function suitable for mapper usage
+     */
+    static createResolver(options?: IAssetReferenceOptions): (value: unknown, context: ISeedContext) => string | null;
+}
+//# sourceMappingURL=AssetReferenceResolver.d.ts.map

package/utils/AssetReferenceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetReferenceResolver.d.ts","sourceRoot":"","sources":["../../src/utils/AssetReferenceResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IAInC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CAI3B;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IAI/B;;OAEG;IACH,gBAAuB,cAAc,EAAE,MAAM,CAAa;IAM1D,OAAO;IAQP;;;;;;;OAOG;WACW,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IA4B7G;;;;;OAKG;WACW,cAAc,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,MAAM,GAAG,IAAI;CAQ3H"}

package/utils/AssetReferenceResolver.js

@@ -0,0 +1,62 @@
+// #region Imports
+/**
+ * Resolves asset references inside JSON seed payloads.
+ *
+ * @public
+ */
+export class AssetReferenceResolver {
+    // #region Fields
+    /**
+     * Default prefix that indicates an asset reference.
+     */
+    static DEFAULT_PREFIX = '@asset:';
+    // #endregion
+    // #region Ctor
+    constructor() {
+        // Utility class
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Resolves a potential asset reference to a concrete asset URL.
+     *
+     * @param value The JSON value that may contain an asset reference
+     * @param context Seeder execution context
+     * @param options Optional resolution configuration
+     * @returns The resolved asset URL or the normalized value when no prefix is present
+     */
+    static resolve(value, context, options) {
+        if (typeof value !== 'string') {
+            return value === undefined || value === null ? null : String(value);
+        }
+        const prefix = options?.prefix ?? AssetReferenceResolver.DEFAULT_PREFIX;
+        const shouldTrim = options?.trim ?? true;
+        const normalizedValue = shouldTrim ? value.trim() : value;
+        if (!normalizedValue.startsWith(prefix)) {
+            return normalizedValue;
+        }
+        const assetKey = normalizedValue.slice(prefix.length);
+        if (assetKey.length === 0) {
+            context.logger.warn('Encountered empty asset reference.');
+            return null;
+        }
+        const assetUrl = context.assets.getAsset(assetKey);
+        if (!assetUrl) {
+            context.logger.warn(`Asset not found for key: ${assetKey}`);
+            return null;
+        }
+        return assetUrl;
+    }
+    /**
+     * Creates a reusable resolver function with the provided options.
+     *
+     * @param options Optional resolution options
+     * @returns A resolver function suitable for mapper usage
+     */
+    static createResolver(options) {
+        return (value, context) => {
+            return AssetReferenceResolver.resolve(value, context, options);
+        };
+    }
+}
+//# sourceMappingURL=AssetReferenceResolver.js.map

package/utils/AssetReferenceResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssetReferenceResolver.js","sourceRoot":"","sources":["../../src/utils/AssetReferenceResolver.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAiClB;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAE/B,iBAAiB;IAEjB;;OAEG;IACI,MAAM,CAAU,cAAc,GAAW,SAAS,CAAC;IAE1D,aAAa;IAEb,eAAe;IAEf;QACI,gBAAgB;IACpB,CAAC;IAED,aAAa;IAEb,kBAAkB;IAElB;;;;;;;OAOG;IACI,MAAM,CAAC,OAAO,CAAC,KAAc,EAAE,OAAqB,EAAE,OAAgC;QACzF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,MAAM,GAAW,OAAO,EAAE,MAAM,IAAI,sBAAsB,CAAC,cAAc,CAAC;QAChF,MAAM,UAAU,GAAY,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;QAClD,MAAM,eAAe,GAAW,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAElE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,OAAO,eAAe,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAW,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAuB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;YAC5D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,cAAc,CAAC,OAAgC;QACzD,OAAO,CAAC,KAAc,EAAE,OAAqB,EAAiB,EAAE;YAC5D,OAAO,sBAAsB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnE,CAAC,CAAC;IACN,CAAC"}

package/utils/EntityLookupCache.d.ts

@@ -0,0 +1,47 @@
+import type { ISeedContext } from '../config/ISeedContext.js';
+/**
+ * Describes a resolver capable of translating string keys to entity identifiers.
+ *
+ * @public
+ */
+export interface IEntityLookupResolver<TResult> {
+    /**
+     * Resolves the entity identifier for the provided key.
+     *
+     * @param key Key identifying the entity
+     * @param context Seeder execution context
+     */
+    resolve(key: string, context: ISeedContext): Promise<TResult>;
+}
+/**
+ * Provides a caching layer for expensive lookup operations in JSON seed mappers.
+ *
+ * @public
+ */
+export declare class EntityLookupCache<TResult> {
+    private readonly cache;
+    private readonly resolver;
+    constructor(resolver: IEntityLookupResolver<TResult>);
+    /**
+     * Resolves a value for the provided key, using the cache when available.
+     *
+     * @param key Lookup key
+     * @param context Seeder execution context
+     * @returns Resolved value
+     */
+    resolve(key: string, context: ISeedContext): Promise<TResult>;
+    /**
+     * Resolves multiple keys sequentially, preserving order.
+     *
+     * @param keys Lookup keys
+     * @param context Seeder execution context
+     * @returns Resolved values
+     */
+    resolveMany(keys: readonly string[], context: ISeedContext): Promise<readonly TResult[]>;
+    /**
+     * Clears the internal cache.
+     */
+    clear(): void;
+    private static normalizeKey;
+}
+//# sourceMappingURL=EntityLookupCache.d.ts.map

package/utils/EntityLookupCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityLookupCache.d.ts","sourceRoot":"","sources":["../../src/utils/EntityLookupCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAI1C;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAIjE;AAED;;;;GAIG;AACH,qBAAa,iBAAiB,CAAC,OAAO;IAIlC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;gBAMvC,QAAQ,EAAE,qBAAqB,CAAC,OAAO,CAAC;IAS3D;;;;;;OAMG;IACU,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1E;;;;;;OAMG;IACU,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC;IASrG;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB,OAAO,CAAC,MAAM,CAAC,YAAY;CAW9B"}