@breadstone-infrastructure/prisma-seeds 0.0.231

package/json/createJsonSeeder.js

@@ -0,0 +1,240 @@
+// #region Imports
+import { dirname } from 'node:path';
+import { Path } from '@breadstone-infrastructure/utilities';
+import { createFunctionalSeeder } from '../base/functionalSeeder.js';
+import { JsonSeedLoader } from './JsonSeedLoader.js';
+import { JsonReferenceResolver } from './JsonReferenceResolver.js';
+// #endregion
+/**
+ * Create a JSON-based seeder that loads data from JSON files.
+ *
+ * @public
+ * @template TJson The type of the JSON data
+ * @template TPrisma The type of the Prisma input
+ * @param config JSON seed configuration
+ * @returns A functional seeder that uses JSON files
+ */
+export function createJsonSeeder(config) {
+    const resolveBasePath = (seedContext) => {
+        if (seedContext.seedConfigPath) {
+            return dirname(seedContext.seedConfigPath);
+        }
+        return process.cwd();
+    };
+    return createFunctionalSeeder({
+        name: config.name,
+        run: async (context, utilities) => {
+            const loader = new JsonSeedLoader(context.logger);
+            const basePath = resolveBasePath(context);
+            const wrapperKeys = config.wrapperKey
+                ? Array.isArray(config.wrapperKey)
+                    ? config.wrapperKey
+                    : [config.wrapperKey]
+                : undefined;
+            const loadOptions = wrapperKeys && wrapperKeys.length > 0 ? { wrapperKeys } : undefined;
+            context.logger.info(`Loading JSON data from: ${JSON.stringify(config.sources)}`);
+            const validationResult = config.schema
+                ? await loader.loadWithSchema(config.sources, config.schema, basePath, loadOptions)
+                : {
+                    isValid: true,
+                    errors: [],
+                    data: await loader.load(config.sources, basePath, loadOptions)
+                };
+            if (!validationResult.isValid) {
+                context.logger.error(`JSON validation failed: ${validationResult.errors.join(', ')}`);
+                return utilities.createSeedResult(0, 0, validationResult.errors);
+            }
+            let items = validationResult.data;
+            if (!Array.isArray(items)) {
+                items = [items];
+            }
+            context.logger.info(`Loaded ${items.length} items from JSON files`);
+            // Resolve references if configured
+            if (config.references) {
+                const resolver = new JsonReferenceResolver(config.references);
+                items = (await resolver.resolve(items, context));
+                context.logger.debug('Resolved all references');
+            }
+            // Apply mapper pre-processing FIRST
+            if (config.mapper?.preProcess) {
+                items = await Promise.all(items.map((item) => {
+                    if (config.mapper?.preProcess) {
+                        return config.mapper.preProcess(item, context);
+                    }
+                    return item;
+                }));
+            }
+            // Store unique field values by index AFTER preprocessing
+            const uniqueFieldsByIndex = [];
+            if (config.upsert) {
+                const uniqueFields = Array.isArray(config.upsert.uniqueFields)
+                    ? config.upsert.uniqueFields
+                    : [config.upsert.uniqueFields];
+                for (let idx = 0; idx < items.length; idx++) {
+                    const item = items[idx];
+                    const metadata = {};
+                    for (const field of uniqueFields) {
+                        metadata[field] = item[field];
+                    }
+                    uniqueFieldsByIndex.push(metadata);
+                }
+            } // Persist to database
+            const { result, duration } = await utilities.measureExecutionTime(async () => {
+                let created = 0;
+                let updated = 0;
+                const errors = [];
+                const modelName = config.model.charAt(0).toLowerCase() + config.model.slice(1);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const prismaRecord = context.prisma;
+                const modelDelegate = prismaRecord[modelName];
+                if (!modelDelegate) {
+                    throw new Error(`Prisma model "${config.model}" not found`);
+                }
+                const batchSize = config.batch?.size ?? items.length; // Process all items at once if no batch size specified
+                const useTransaction = config.batch?.useTransaction ?? false;
+                for (let i = 0; i < items.length; i += batchSize) {
+                    const batch = items.slice(i, i + batchSize);
+                    const processBatch = async () => {
+                        for (let batchIndex = 0; batchIndex < batch.length; batchIndex++) {
+                            const item = batch[batchIndex];
+                            const itemIndex = i + batchIndex;
+                            try {
+                                // Handle upsert or create
+                                if (config.upsert) {
+                                    const uniqueFields = Array.isArray(config.upsert.uniqueFields)
+                                        ? config.upsert.uniqueFields
+                                        : [config.upsert.uniqueFields];
+                                    // Build where clause from preserved original unique fields by index
+                                    const whereClause = {};
+                                    const originalFields = uniqueFieldsByIndex[itemIndex];
+                                    if (originalFields) {
+                                        Object.assign(whereClause, originalFields);
+                                    }
+                                    else {
+                                        for (const field of uniqueFields) {
+                                            whereClause[field] = item[field];
+                                        }
+                                    }
+                                    // Map to Prisma input after building where clause
+                                    const createInput = config.mapper
+                                        ? await config.mapper.mapToCreate(item, context)
+                                        : item;
+                                    const existing = await modelDelegate.findFirst({
+                                        where: whereClause
+                                    });
+                                    if (existing && config.upsert.updateExisting) {
+                                        const updateInput = config.mapper?.mapToUpdate
+                                            ? await config.mapper.mapToUpdate(item, existing, context)
+                                            : createInput;
+                                        // Use id if available and not null, otherwise use compound format for composite keys
+                                        let updateWhere;
+                                        if (existing.id !== undefined && existing.id !== null) {
+                                            updateWhere = { id: existing.id };
+                                        }
+                                        else if (uniqueFields.length > 1) {
+                                            // Composite key: format as fieldA_fieldB: { fieldA, fieldB }
+                                            const compoundKey = uniqueFields.join('_');
+                                            updateWhere = { [compoundKey]: whereClause };
+                                        }
+                                        else {
+                                            updateWhere = whereClause;
+                                        }
+                                        await modelDelegate.update({
+                                            where: updateWhere,
+                                            data: updateInput
+                                        });
+                                        updated += 1;
+                                    }
+                                    else if (!existing) {
+                                        await modelDelegate.create({
+                                            data: createInput
+                                        });
+                                        created += 1;
+                                    }
+                                }
+                                else {
+                                    // No upsert, just create - map input here
+                                    const createInput = config.mapper
+                                        ? await config.mapper.mapToCreate(item, context)
+                                        : item;
+                                    await modelDelegate.create({
+                                        data: createInput
+                                    });
+                                    created += 1;
+                                }
+                            }
+                            catch (error) {
+                                const errorMsg = `Failed to process item: ${error}`;
+                                context.logger.error(errorMsg);
+                                errors.push(errorMsg);
+                            }
+                        }
+                    };
+                    if (useTransaction) {
+                        await context.prisma.$transaction(async () => {
+                            await processBatch();
+                        });
+                    }
+                    else {
+                        await processBatch();
+                    }
+                }
+                return {
+                    created,
+                    updated,
+                    errors
+                };
+            });
+            if (result.created > 0 || result.updated > 0) {
+                context.logger.summary(`${result.created} created, ${result.updated} updated (${duration}ms)`);
+            }
+            // Log warning summary if any warnings were collected
+            if (context.warnings?.hasWarnings()) {
+                context.warnings.logSummary(5); // Show top 5 unique warnings
+            }
+            return utilities.createSeedResult(result.created + result.updated, duration, result.errors, [], {
+                created: result.created,
+                updated: result.updated
+            });
+        },
+        validate: async (context) => {
+            if (!config.enabled) {
+                return true;
+            }
+            // Check if model exists
+            const modelName = config.model.charAt(0).toLowerCase() + config.model.slice(1);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const prismaRecord = context.prisma;
+            const modelDelegate = prismaRecord[modelName];
+            if (!modelDelegate) {
+                context.logger.warn(`Prisma model "${config.model}" not found`);
+                return false;
+            }
+            // Check if source files exist
+            const basePath = resolveBasePath(context);
+            const sources = Array.isArray(config.sources) ? config.sources : [config.sources];
+            for (const source of sources) {
+                const absoluteSource = Path.isAbsolute(source) ? source : Path.resolve(basePath, source);
+                const files = Path.glob(absoluteSource);
+                if (files.length === 0) {
+                    context.logger.warn(`No JSON files found matching: ${source}`);
+                    return false;
+                }
+            }
+            return true;
+        },
+        cleanup: async (context) => {
+            if (config.enabled) {
+                const modelName = config.model.charAt(0).toLowerCase() + config.model.slice(1);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const prismaRecord = context.prisma;
+                const modelDelegate = prismaRecord[modelName];
+                if (modelDelegate) {
+                    context.logger.debug(`Cleaning up JSON-seeded ${config.model} data...`);
+                    await modelDelegate.deleteMany({});
+                }
+            }
+        }
+    });
+}
+//# sourceMappingURL=createJsonSeeder.js.map

package/json/createJsonSeeder.js.map

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

package/json/index.d.ts

@@ -0,0 +1,6 @@
+export type { IJsonSeedConfig, IJsonSeedMapper, IJsonReferenceConfig, IJsonReferenceResolver, IJsonValidationResult, IJsonSeedLoadOptions } from './JsonSeedTypes.js';
+export { JsonSeedLoader } from './JsonSeedLoader.js';
+export { JsonSchemaValidator } from './JsonSchemaValidator.js';
+export { JsonReferenceResolver } from './JsonReferenceResolver.js';
+export { createJsonSeeder } from './createJsonSeeder.js';
+//# sourceMappingURL=index.d.ts.map

package/json/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACR,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/json/index.js

@@ -0,0 +1,7 @@
+// #region Exports
+export { JsonSeedLoader } from './JsonSeedLoader.js';
+export { JsonSchemaValidator } from './JsonSchemaValidator.js';
+export { JsonReferenceResolver } from './JsonReferenceResolver.js';
+export { createJsonSeeder } from './createJsonSeeder.js';
+// #endregion
+//# sourceMappingURL=index.js.map

package/json/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAUlB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,aAAa"}

package/logging/ISeedLogger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Logger interface for seeding operations.
+ *
+ * @public
+ */
+export interface ISeedLogger {
+    /**
+     * Log an informational message.
+     *
+     * @param message The message to log.
+     */
+    info(message: string): void;
+    /**
+     * Log a warning message.
+     *
+     * @param message The message to log.
+     */
+    warn(message: string): void;
+    /**
+     * Log an error message.
+     *
+     * @param message The message to log.
+     */
+    error(message: string): void;
+    /**
+     * Log a debug message.
+     *
+     * @param message The message to log.
+     */
+    debug(message: string): void;
+    /**
+     * Start a log group with a title.
+     * Subsequent logs will be indented until endGroup() is called.
+     *
+     * @param title The group title.
+     */
+    startGroup(title: string): void;
+    /**
+     * End the current log group and restore previous indentation.
+     */
+    endGroup(): void;
+    /**
+     * Log a success message.
+     *
+     * @param message The message to log.
+     */
+    success(message: string): void;
+    /**
+     * Log a summary line (typically used for aggregated information).
+     *
+     * @param message The message to log.
+     */
+    summary(message: string): void;
+}
+//# sourceMappingURL=ISeedLogger.d.ts.map

package/logging/ISeedLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISeedLogger.d.ts","sourceRoot":"","sources":["../../src/logging/ISeedLogger.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAIxB;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;OAEG;IACH,QAAQ,IAAI,IAAI,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAIlC"}

package/logging/ISeedLogger.js

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

package/logging/ISeedLogger.js.map

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

package/logging/LogLevel.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Available log types.
+ *
+ * @public
+ */
+export type LogType = 'error' | 'warn' | 'info' | 'debug' | 'success' | 'summary';
+/**
+ * Log level configuration.
+ * Defines which log types should be displayed.
+ *
+ * @public
+ */
+export type LogLevel = LogType | 'silent';
+/**
+ * Default log level.
+ *
+ * @public
+ */
+export declare const DEFAULT_LOG_LEVEL: LogLevel;
+/**
+ * Check if a log type should be displayed based on the configured log level.
+ *
+ * @param logType The type of log message
+ * @param configuredLevel The configured log level
+ * @returns True if the log should be displayed
+ *
+ * @public
+ */
+export declare function shouldLog(logType: LogType, configuredLevel: LogLevel): boolean;
+//# sourceMappingURL=LogLevel.d.ts.map

package/logging/LogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.d.ts","sourceRoot":"","sources":["../../src/logging/LogLevel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAElF;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAiB,CAAC;AAgBlD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,GAAG,OAAO,CAS9E"}

package/logging/LogLevel.js

@@ -0,0 +1,37 @@
+/**
+ * Default log level.
+ *
+ * @public
+ */
+export const DEFAULT_LOG_LEVEL = 'info';
+/**
+ * Log level hierarchy (lower number = higher priority).
+ *
+ * @internal
+ */
+export const LOG_LEVEL_PRIORITY = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    success: 2,
+    summary: 2,
+    debug: 3
+};
+/**
+ * Check if a log type should be displayed based on the configured log level.
+ *
+ * @param logType The type of log message
+ * @param configuredLevel The configured log level
+ * @returns True if the log should be displayed
+ *
+ * @public
+ */
+export function shouldLog(logType, configuredLevel) {
+    if (configuredLevel === 'silent') {
+        return false;
+    }
+    const configuredPriority = LOG_LEVEL_PRIORITY[configuredLevel];
+    const logTypePriority = LOG_LEVEL_PRIORITY[logType];
+    return logTypePriority <= configuredPriority;
+}
+//# sourceMappingURL=LogLevel.js.map

package/logging/LogLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../src/logging/LogLevel.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAa,MAAM,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA4B;IACvD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACX,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,eAAyB;IACjE,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,eAA0B,CAAC,CAAC;IAC1E,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEpD,OAAO,eAAe,IAAI,kBAAkB,CAAC;AACjD,CAAC"}

package/logging/SeedLogger.d.ts

@@ -0,0 +1,24 @@
+import type { ISeedLogger } from './ISeedLogger.js';
+import { ConsoleLogger } from '@breadstone-infrastructure/utilities';
+import type { LogLevel } from './LogLevel.js';
+/**
+ * The `SeedLogger` class with support for grouped/hierarchical logging.
+ *
+ * @public
+ */
+export declare class SeedLogger extends ConsoleLogger implements ISeedLogger {
+    private _groupStack;
+    private _isGroupActive;
+    private readonly _logLevel;
+    constructor(logLevel?: LogLevel);
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    success(message: string): void;
+    summary(message: string): void;
+    startGroup(title: string): void;
+    endGroup(): void;
+    private _getIndent;
+}
+//# sourceMappingURL=SeedLogger.d.ts.map

package/logging/SeedLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedLogger.d.ts","sourceRoot":"","sources":["../../src/logging/SeedLogger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAQ,aAAa,EAA8G,MAAM,sCAAsC,CAAC;AACvL,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAK9C;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,aAAc,YAAW,WAAW;IAIhE,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;gBAMlB,QAAQ,GAAE,QAA4B;IASzC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQrC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQ9B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB/B,QAAQ,IAAI,IAAI;IAUvB,OAAO,CAAC,UAAU;CAWrB"}

package/logging/SeedLogger.js

@@ -0,0 +1,94 @@
+// #region Imports
+import { blue, ConsoleLogger, magenta, red, yellow, t, bgBlue, bgYellow, bgRed, bgMagenta, bold, white, black, green, bgGreen, gray, dim } from '@breadstone-infrastructure/utilities';
+import { DEFAULT_LOG_LEVEL, shouldLog } from './LogLevel.js';
+// #endregion
+/**
+ * The `SeedLogger` class with support for grouped/hierarchical logging.
+ *
+ * @public
+ */
+export class SeedLogger extends ConsoleLogger {
+    // #region Fields
+    _groupStack = [];
+    _isGroupActive = false;
+    _logLevel;
+    // #endregion
+    // #region Ctor
+    constructor(logLevel = DEFAULT_LOG_LEVEL) {
+        super();
+        this._logLevel = logLevel;
+    }
+    // #endregion
+    // #region Methods
+    info(message) {
+        if (!shouldLog('info', this._logLevel)) {
+            return;
+        }
+        const indent = this._getIndent();
+        super.info(t `${indent}${bgBlue(bold(white(' info ')))}  ${blue(message)}`);
+    }
+    warn(message) {
+        if (!shouldLog('warn', this._logLevel)) {
+            return;
+        }
+        const indent = this._getIndent();
+        super.warn(t `${indent}${bgYellow(bold(black(' warn ')))}  ${yellow(message)}`);
+    }
+    error(message) {
+        if (!shouldLog('error', this._logLevel)) {
+            return;
+        }
+        const indent = this._getIndent();
+        super.error(t `${indent}${bgRed(bold(black(' error ')))}  ${red(message)}`);
+    }
+    debug(message) {
+        if (!shouldLog('debug', this._logLevel)) {
+            return;
+        }
+        const indent = this._getIndent();
+        super.debug(t `${indent}${bgMagenta(bold(black(' debug ')))}  ${magenta(message)}`);
+    }
+    success(message) {
+        if (!shouldLog('success', this._logLevel)) {
+            return;
+        }
+        const indent = this._getIndent();
+        super.info(t `${indent}${bgGreen(bold(black(' ✓ ')))}  ${green(message)}`);
+    }
+    summary(message) {
+        if (!shouldLog('summary', this._logLevel)) {
+            return;
+        }
+        const indent = this._getIndent();
+        super.info(t `${indent}${dim(gray('  ╰─'))}  ${gray(message)}`);
+    }
+    startGroup(title) {
+        if (!shouldLog('info', this._logLevel)) {
+            // Still track group stack even if not logging
+            this._groupStack.push(title);
+            this._isGroupActive = true;
+            return;
+        }
+        const indent = this._getIndent();
+        this._groupStack.push(title);
+        this._isGroupActive = true;
+        const prefix = this._groupStack.length === 1 ? '┌' : '├';
+        super.info(t `${indent}${dim(gray(`  ${prefix}─`))}  ${bold(white(title))}`);
+    }
+    endGroup() {
+        if (this._groupStack.length > 0) {
+            this._groupStack.pop();
+        }
+        if (this._groupStack.length === 0) {
+            this._isGroupActive = false;
+        }
+    }
+    _getIndent() {
+        if (this._groupStack.length === 0) {
+            return '  ';
+        }
+        // Each group level adds 2 spaces of indentation
+        return '  ' + '  '.repeat(this._groupStack.length);
+    }
+}
+//# sourceMappingURL=SeedLogger.js.map

package/logging/SeedLogger.js.map

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

package/orchestration/SeedOrchestrator.d.ts

@@ -0,0 +1,30 @@
+import type { ISeedOptions } from '../config/ISeedOptions.js';
+import type { ISeedResult } from '../config/ISeedResult.js';
+export interface ISeedOrchestrationResult {
+    readonly success: boolean;
+    readonly totalItemsCreated: number;
+    readonly totalDuration: number;
+    readonly seedResults: Array<{
+        readonly name: string;
+        readonly result: ISeedResult;
+    }>;
+    readonly errors: string[];
+}
+export declare class SeedOrchestrator {
+    private readonly _discovery;
+    private _logger;
+    constructor();
+    /**
+     * @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.
+     */
+    executeWithOverrides(rootPath: string, overrides: Partial<ISeedOptions>): Promise<ISeedOrchestrationResult>;
+    /**
+     * @description Runs seeding with explicit options (no config file merging).
+     */
+    execute(rootPath: string, options: ISeedOptions): Promise<ISeedOrchestrationResult>;
+    private _executeWithComposedConfig;
+    private createContext;
+}
+//# sourceMappingURL=SeedOrchestrator.d.ts.map

package/orchestration/SeedOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedOrchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestration/SeedOrchestrator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAU5D,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;KAChC,CAAC,CAAC;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,OAAO,CAAc;;IAgB7B;;;;OAIG;IACU,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAmBxH;;OAEG;IACU,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,wBAAwB,CAAC;YASlF,0BAA0B;YA8G1B,aAAa;CAkJ9B"}