@breadstone-infrastructure/prisma-seeds 0.0.231

package/config/createAdapter.js

@@ -0,0 +1,16 @@
+// #region Imports
+import { createBlobAdapter } from '../assets/adapters/createBlobAdapter.js';
+// #endregion
+/**
+ * Factory function to create a blob adapter based on type and configuration.
+ *
+ * @param type The type of blob adapter to create.
+ * @param config The configuration object for the adapter.
+ * @returns An instance of the requested blob adapter.
+ * @throws Error if the adapter type is unsupported.
+ * @public
+ */
+export function createAdapter(type, config) {
+    return createBlobAdapter(type, config);
+}
+//# sourceMappingURL=createAdapter.js.map

package/config/createAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdapter.js","sourceRoot":"","sources":["../../src/config/createAdapter.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAGlB,OAAO,EAAmB,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE7F,aAAa;AAEb;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAqB,EAAE,MAAY;IAC7D,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/config/createSeed.d.ts

@@ -0,0 +1,6 @@
+import type { ISeedDefinition } from './ISeedDefinition';
+/**
+ * Create a seed definition with factory pattern
+ */
+export declare function createSeed(name: string, factory: () => any, options?: Record<string, unknown>): ISeedDefinition;
+//# sourceMappingURL=createSeed.d.ts.map

package/config/createSeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSeed.d.ts","sourceRoot":"","sources":["../../src/config/createSeed.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAS/G"}

package/config/createSeed.js

@@ -0,0 +1,16 @@
+// #region Imports
+// #endregion
+/**
+ * Create a seed definition with factory pattern
+ */
+export function createSeed(name, factory, options) {
+    return {
+        name,
+        enabled: true,
+        factory: {
+            create: factory
+        },
+        options: options ?? {}
+    };
+}
+//# sourceMappingURL=createSeed.js.map

package/config/createSeed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSeed.js","sourceRoot":"","sources":["../../src/config/createSeed.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAIlB,aAAa;AAEb;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAkB,EAAE,OAAiC;IAC1F,OAAO;QACH,IAAI;QACJ,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACL,MAAM,EAAE,OAAO;SAClB;QACD,OAAO,EAAE,OAAO,IAAI,EAAE;KACzB,CAAC;AACN,CAAC"}

package/config/defineConfig.d.ts

@@ -0,0 +1,27 @@
+import type { IAISeedConfig } from '../ai/AISeedTypes.js';
+import type { IAssetConfig } from './IAssetConfig.js';
+import type { ISeedConfig } from './ISeedConfig.js';
+import type { ISeedDefinition } from './ISeedDefinition.js';
+import type { ISeedOptions } from './ISeedOptions.js';
+/**
+ * Input type for defining a seed configuration.
+ *
+ * @public
+ */
+export interface ISeedConfigInput {
+    readonly name: string;
+    readonly enabled?: boolean;
+    readonly order?: number;
+    readonly dependencies?: string[];
+    readonly seeds?: ISeedDefinition[];
+    readonly searchPaths?: string[];
+    readonly ai?: IAISeedConfig;
+    readonly assets?: IAssetConfig;
+    readonly logLevel?: import('../logging/LogLevel.js').LogLevel;
+    readonly options?: ISeedOptions;
+}
+/**
+ * Define a seed configuration for a project or feature.
+ */
+export declare function defineConfig(config: ISeedConfigInput): ISeedConfig;
+//# sourceMappingURL=defineConfig.d.ts.map

package/config/defineConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,wBAAwB,EAAE,QAAQ,CAAC;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAmClE"}

package/config/defineConfig.js

@@ -0,0 +1,35 @@
+// #region Imports
+/**
+ * Define a seed configuration for a project or feature.
+ */
+export function defineConfig(config) {
+    const baseConfig = {
+        name: config.name,
+        enabled: config.enabled ?? true,
+        order: config.order ?? 0,
+        dependencies: config.dependencies ?? [],
+        seeds: config.seeds ?? []
+    };
+    // Add optional AI configuration
+    if (config.ai) {
+        baseConfig.ai = config.ai;
+    }
+    // Add optional asset configuration
+    if (config.assets) {
+        baseConfig.assets = config.assets;
+    }
+    // Add optional log level configuration
+    if (config.logLevel) {
+        baseConfig.logLevel = config.logLevel;
+    }
+    // Add searchPaths for extended configuration (root configs)
+    if (config.searchPaths) {
+        baseConfig.searchPaths = config.searchPaths;
+    }
+    // Add default runtime options
+    if (config.options) {
+        baseConfig.options = config.options;
+    }
+    return baseConfig;
+}
+//# sourceMappingURL=defineConfig.js.map

package/config/defineConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConfig.js","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAAA,kBAAkB;AA4BlB;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAwB;IACjD,MAAM,UAAU,GAAgB;QAC5B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;KAC5B,CAAC;IAEF,gCAAgC;IAChC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACX,UAAkD,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,mCAAmC;IACnC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACf,UAAqD,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClF,CAAC;IAED,uCAAuC;IACvC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjB,UAAoF,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACrH,CAAC;IAED,4DAA4D;IAC5D,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACpB,UAAsD,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC7F,CAAC;IAED,8BAA8B;IAC9B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAChB,UAAsD,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACrF,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/discovery/SeedConfigDiscovery.d.ts

@@ -0,0 +1,16 @@
+import type { IComposedSeedConfig } from '../config/IComposedSeedConfig.js';
+export interface ISeedConfigDiscoveryOptions {
+    readonly rootPath: string;
+    readonly searchPaths?: string[];
+    readonly configFileName?: string;
+}
+export declare class SeedConfigDiscovery {
+    private readonly _fs;
+    private readonly _configFileNames;
+    private readonly _logger;
+    constructor();
+    discover(options: ISeedConfigDiscoveryOptions): Promise<IComposedSeedConfig>;
+    private loadConfig;
+    private resolveExecutionOrder;
+}
+//# sourceMappingURL=SeedConfigDiscovery.d.ts.map

package/discovery/SeedConfigDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedConfigDiscovery.d.ts","sourceRoot":"","sources":["../../src/discovery/SeedConfigDiscovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAQ5E,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;;IAuBxB,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAmD3E,UAAU;IAuBxB,OAAO,CAAC,qBAAqB;CAkEhC"}

package/discovery/SeedConfigDiscovery.js

@@ -0,0 +1,137 @@
+// #region Imports
+import { glob } from 'glob';
+import { FileSystem } from '@breadstone-infrastructure/utilities';
+import { SeedLogger } from '../logging/SeedLogger.js';
+export class SeedConfigDiscovery {
+    // #region Fields
+    _fs;
+    _configFileNames;
+    _logger;
+    // #endregion
+    // #region Ctor
+    constructor() {
+        this._fs = new FileSystem();
+        this._configFileNames = [
+            'seed.config.js',
+            'seed.config.cjs',
+            'seed.config.mjs',
+            'seed.config.ts',
+            'seed.config.cts',
+            'seed.config.mts'
+        ];
+        this._logger = new SeedLogger();
+    }
+    // #endregion
+    // #region Methods
+    async discover(options) {
+        let rootConfigPath = '';
+        let rootConfig = null;
+        for (const configFileName of this._configFileNames) {
+            const configPath = this._fs.pathCombine(options.rootPath, configFileName);
+            if (this._fs.fileExists(configPath)) {
+                rootConfigPath = configPath;
+                rootConfig = await this.loadConfig(configPath);
+                Object.assign(rootConfig, { configPath });
+                break;
+            }
+        }
+        if (!rootConfig) {
+            throw new Error(`No seed config file found in root path: ${options.rootPath}`);
+        }
+        const extendedRootConfig = rootConfig;
+        const searchPaths = extendedRootConfig.searchPaths ?? options.searchPaths ?? [];
+        const featureConfigs = [];
+        for (const searchPath of searchPaths) {
+            const patterns = this._configFileNames.map((name) => this._fs.pathCombine(options.rootPath, searchPath, `**/${name}`));
+            const configFiles = (await Promise.all(patterns.map((pattern) => glob(pattern)))).flat();
+            for (const configFile of configFiles) {
+                if (configFile === rootConfigPath) {
+                    continue;
+                }
+                try {
+                    const config = await this.loadConfig(configFile);
+                    Object.assign(config, { configPath: configFile });
+                    featureConfigs.push(config);
+                }
+                catch (error) {
+                    this._logger.warn(`Failed to load config from ${configFile}: ${error}`);
+                }
+            }
+        }
+        const resolved = this.resolveExecutionOrder([rootConfig, ...featureConfigs]);
+        return {
+            rootConfig,
+            featureConfigs,
+            resolved
+        };
+    }
+    async loadConfig(configPath) {
+        const resolvedPath = this._fs.pathResolve(configPath);
+        if (resolvedPath.endsWith('.ts') || resolvedPath.endsWith('.cts') || resolvedPath.endsWith('.mts')) {
+            throw new Error(`TypeScript config files are not supported: '${configPath}'. Please use .mjs format instead.`);
+        }
+        if (resolvedPath.endsWith('.js') || resolvedPath.endsWith('.cjs')) {
+            throw new Error(`CommonJS/JavaScript config files are not supported: '${configPath}'. Please use .mjs format instead.`);
+        }
+        if (!resolvedPath.endsWith('.mjs')) {
+            throw new Error(`Unsupported config file format: '${configPath}'. Only .mjs files are supported.`);
+        }
+        try {
+            const moduleResult = await import(resolvedPath);
+            return moduleResult.default || moduleResult;
+        }
+        catch (error) {
+            throw new Error(`Failed to load seed config from ${resolvedPath}: ${error}`);
+        }
+    }
+    resolveExecutionOrder(configs) {
+        const sorted = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (config) => {
+            if (visiting.has(config.name)) {
+                throw new Error(`Circular dependency detected: ${config.name}`);
+            }
+            if (visited.has(config.name)) {
+                return;
+            }
+            visiting.add(config.name);
+            for (const dep of config.dependencies || []) {
+                const depConfig = configs.find((candidate) => candidate.name === dep);
+                if (depConfig) {
+                    visit(depConfig);
+                }
+            }
+            visiting.delete(config.name);
+            visited.add(config.name);
+            sorted.push(config);
+        };
+        const orderedConfigs = [...configs].sort((a, b) => (a.order || 0) - (b.order || 0));
+        for (const config of orderedConfigs) {
+            if (config.enabled !== false) {
+                visit(config);
+            }
+        }
+        const allSeeds = sorted.flatMap((config) => {
+            return config.seeds
+                .filter((seed) => seed.enabled !== false)
+                .map((seed) => {
+                if (config.configPath) {
+                    return {
+                        ...seed,
+                        configPath: config.configPath
+                    };
+                }
+                return seed;
+            });
+        });
+        // Extract logLevel from root config (first config with logLevel defined)
+        const logLevel = configs.find((config) => config.logLevel !== undefined)?.logLevel;
+        return {
+            seeds: allSeeds,
+            executionOrder: sorted.map((config) => config.name),
+            logLevel
+        };
+    }
+}
+//# sourceMappingURL=SeedConfigDiscovery.js.map

package/discovery/SeedConfigDiscovery.js.map

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

package/index.d.ts

@@ -0,0 +1,32 @@
+export * from './config/defineConfig.js';
+export * from './config/createSeed.js';
+export * from './config/IComposedSeedConfig.js';
+export * from './config/ISeedConfig.js';
+export * from './config/ISeedDefinition.js';
+export * from './config/ISeedFactory.js';
+export * from './logging/ISeedLogger.js';
+export * from './logging/LogLevel.js';
+export * from './config/ISeedOptions.js';
+export * from './config/ISeedContext.js';
+export * from './config/ISeedResult.js';
+export * from './config/ISeeder.js';
+export * from './config/IAssetConfig.js';
+export * from './discovery/SeedConfigDiscovery.js';
+export * from './orchestration/SeedOrchestrator.js';
+export * from './base/BaseSeeder.js';
+export * from './base/functionalSeeder.js';
+export * from './utils/SeededRandom.js';
+export * from './utils/ISeedRandom.js';
+export * from './utils/AssetReferenceResolver.js';
+export * from './utils/LocalizationToolkit.js';
+export * from './utils/EntityLookupCache.js';
+export * from './utils/StringArrayToolkit.js';
+export * from './utils/StringValueGuard.js';
+export * from './utils/WarningCollector.js';
+export * from './resolvers/EntityResolver.js';
+export * from './assets/AssetManager.js';
+export * from './assets/IImageTransformOptions.js';
+export * from './assets/adapters/index.js';
+export * from './ai/index.js';
+export * from './json/index.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/index.js

@@ -0,0 +1,32 @@
+export * from './config/defineConfig.js';
+export * from './config/createSeed.js';
+export * from './config/IComposedSeedConfig.js';
+export * from './config/ISeedConfig.js';
+export * from './config/ISeedDefinition.js';
+export * from './config/ISeedFactory.js';
+export * from './logging/ISeedLogger.js';
+export * from './logging/LogLevel.js';
+export * from './config/ISeedOptions.js';
+export * from './config/ISeedContext.js';
+export * from './config/ISeedResult.js';
+export * from './config/ISeeder.js';
+export * from './config/IAssetConfig.js';
+export * from './discovery/SeedConfigDiscovery.js';
+export * from './orchestration/SeedOrchestrator.js';
+export * from './base/BaseSeeder.js';
+export * from './base/functionalSeeder.js';
+export * from './utils/SeededRandom.js';
+export * from './utils/ISeedRandom.js';
+export * from './utils/AssetReferenceResolver.js';
+export * from './utils/LocalizationToolkit.js';
+export * from './utils/EntityLookupCache.js';
+export * from './utils/StringArrayToolkit.js';
+export * from './utils/StringValueGuard.js';
+export * from './utils/WarningCollector.js';
+export * from './resolvers/EntityResolver.js';
+export * from './assets/AssetManager.js';
+export * from './assets/IImageTransformOptions.js';
+export * from './assets/adapters/index.js';
+export * from './ai/index.js';
+export * from './json/index.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/json/JsonReferenceResolver.d.ts

@@ -0,0 +1,23 @@
+import type { ISeedContext } from '../config/ISeedContext.js';
+import type { IJsonReferenceConfig } from './JsonSeedTypes.js';
+/**
+ * Resolver for references in JSON seed data.
+ *
+ * @public
+ */
+export declare class JsonReferenceResolver {
+    private readonly _config;
+    private readonly _refPrefix;
+    private readonly _assetPrefix;
+    constructor(config: IJsonReferenceConfig);
+    /**
+     * Resolve all references in the given data.
+     *
+     * @param data Data containing references
+     * @param context Seed context
+     * @returns Data with resolved references
+     */
+    resolve(data: unknown, context: ISeedContext): Promise<unknown>;
+    private _resolveValue;
+}
+//# sourceMappingURL=JsonReferenceResolver.d.ts.map

package/json/JsonReferenceResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonReferenceResolver.d.ts","sourceRoot":"","sources":["../../src/json/JsonReferenceResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAI/D;;;;GAIG;AACH,qBAAa,qBAAqB;IAI9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAMnB,MAAM,EAAE,oBAAoB;IAU/C;;;;;;OAMG;IACU,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;YAkB9D,aAAa;CA8D9B"}

package/json/JsonReferenceResolver.js

@@ -0,0 +1,99 @@
+// #region Imports
+// #endregion
+/**
+ * Resolver for references in JSON seed data.
+ *
+ * @public
+ */
+export class JsonReferenceResolver {
+    // #region Fields
+    _config;
+    _refPrefix;
+    _assetPrefix;
+    // #endregion
+    // #region Ctor
+    constructor(config) {
+        this._config = config;
+        this._refPrefix = config.prefix ?? '@ref:';
+        this._assetPrefix = config.assetPrefix ?? '@asset:';
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Resolve all references in the given data.
+     *
+     * @param data Data containing references
+     * @param context Seed context
+     * @returns Data with resolved references
+     */
+    async resolve(data, context) {
+        if (Array.isArray(data)) {
+            return Promise.all(data.map((item) => this.resolve(item, context)));
+        }
+        if (data && typeof data === 'object') {
+            const resolved = {};
+            for (const [key, value] of Object.entries(data)) {
+                resolved[key] = await this._resolveValue(value, context);
+            }
+            return resolved;
+        }
+        return this._resolveValue(data, context);
+    }
+    async _resolveValue(value, context) {
+        // Handle string references
+        if (typeof value === 'string') {
+            // Asset reference
+            if (value.startsWith(this._assetPrefix)) {
+                const assetKey = value.slice(this._assetPrefix.length);
+                const assetUrl = context.assets.getAsset(assetKey);
+                if (!assetUrl) {
+                    if (context.warnings) {
+                        context.warnings.add(`Asset not found: ${assetKey}`);
+                    }
+                    else {
+                        context.logger.warn(`Asset not found: ${assetKey}`);
+                    }
+                    return value;
+                }
+                return assetUrl;
+            }
+            // Entity reference
+            if (value.startsWith(this._refPrefix)) {
+                const refKey = value.slice(this._refPrefix.length);
+                const [type, ...keyParts] = refKey.split(':');
+                const key = keyParts.join(':');
+                const resolver = this._config.resolvers?.[type];
+                if (!resolver) {
+                    if (context.warnings) {
+                        context.warnings.add(`No resolver found for reference type: ${type}`);
+                    }
+                    else {
+                        context.logger.warn(`No resolver found for reference type: ${type}`);
+                    }
+                    return value;
+                }
+                try {
+                    return await resolver.resolve(key, context);
+                }
+                catch (error) {
+                    context.logger.error(`Failed to resolve reference ${value}: ${error}`);
+                    return value;
+                }
+            }
+        }
+        // Handle arrays
+        if (Array.isArray(value)) {
+            return Promise.all(value.map((item) => this._resolveValue(item, context)));
+        }
+        // Handle nested objects
+        if (value && typeof value === 'object') {
+            const resolved = {};
+            for (const [k, v] of Object.entries(value)) {
+                resolved[k] = await this._resolveValue(v, context);
+            }
+            return resolved;
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=JsonReferenceResolver.js.map

package/json/JsonReferenceResolver.js.map

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

package/json/JsonSchemaValidator.d.ts

@@ -0,0 +1,23 @@
+import type { ISeedLogger } from '../logging/ISeedLogger.js';
+import type { IJsonValidationResult } from './JsonSeedTypes.js';
+/**
+ * Validator for JSON data against JSON Schema.
+ *
+ * @public
+ */
+export declare class JsonSchemaValidator {
+    private readonly _fileSystem;
+    private readonly _logger;
+    constructor(logger: ISeedLogger);
+    /**
+     * Validate data against a JSON schema.
+     *
+     * @param data Data to validate
+     * @param schemaPath Path to JSON schema file
+     * @returns Validation result
+     */
+    validate(data: unknown, schemaPath: string): IJsonValidationResult;
+    private _validateAgainstSchema;
+    private _validateDocument;
+}
+//# sourceMappingURL=JsonSchemaValidator.d.ts.map

package/json/JsonSchemaValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSchemaValidator.d.ts","sourceRoot":"","sources":["../../src/json/JsonSchemaValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAIhE;;;;GAIG;AACH,qBAAa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAMnB,MAAM,EAAE,WAAW;IAStC;;;;;;OAMG;IACI,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,qBAAqB;IAgCzE,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,iBAAiB;CAuC5B"}

package/json/JsonSchemaValidator.js

@@ -0,0 +1,98 @@
+// #region Imports
+import { FileSystem } from '@breadstone-infrastructure/utilities';
+// #endregion
+/**
+ * Validator for JSON data against JSON Schema.
+ *
+ * @public
+ */
+export class JsonSchemaValidator {
+    // #region Fields
+    _fileSystem;
+    _logger;
+    // #endregion
+    // #region Ctor
+    constructor(logger) {
+        this._fileSystem = new FileSystem();
+        this._logger = logger;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Validate data against a JSON schema.
+     *
+     * @param data Data to validate
+     * @param schemaPath Path to JSON schema file
+     * @returns Validation result
+     */
+    validate(data, schemaPath) {
+        try {
+            // Load schema
+            const schemaContent = this._fileSystem.fileReadAllText(schemaPath, 'utf-8');
+            const schema = JSON.parse(schemaContent);
+            // Basic validation (can be extended with ajv or similar)
+            const errors = this._validateAgainstSchema(data, schema);
+            if (errors.length > 0) {
+                return {
+                    isValid: false,
+                    errors,
+                    data: undefined
+                };
+            }
+            return {
+                isValid: true,
+                errors: [],
+                data
+            };
+        }
+        catch (error) {
+            this._logger.error(`Schema validation failed: ${error}`);
+            return {
+                isValid: false,
+                errors: [String(error)],
+                data: undefined
+            };
+        }
+    }
+    _validateAgainstSchema(data, schema) {
+        const errors = [];
+        // When validating raw documents (before extraction), each document should be validated individually
+        const documents = Array.isArray(data) ? data : [data];
+        for (const document of documents) {
+            const documentErrors = this._validateDocument(document, schema);
+            errors.push(...documentErrors);
+        }
+        return errors;
+    }
+    _validateDocument(document, schema) {
+        const errors = [];
+        const schemaType = schema['type'];
+        if (schemaType) {
+            const documentType = Array.isArray(document) ? 'array' : typeof document;
+            if (schemaType === 'array') {
+                if (!Array.isArray(document)) {
+                    errors.push(`Expected type array, got ${documentType}`);
+                }
+            }
+            else if (documentType !== schemaType) {
+                errors.push(`Expected type ${String(schemaType)}, got ${documentType}`);
+            }
+        }
+        if (schema['required'] && Array.isArray(schema['required'])) {
+            const requiredFields = schema['required'];
+            if (typeof document !== 'object' || document === null) {
+                errors.push('Required field validation failed: document is not an object');
+                return errors;
+            }
+            for (const requiredField of requiredFields) {
+                if (!(requiredField in document)) {
+                    errors.push(`Missing required field: ${requiredField}`);
+                }
+            }
+        }
+        // TODO: Add more comprehensive validation using ajv or zod
+        // For now, we keep it simple and rely on runtime errors
+        return errors;
+    }
+}
+//# sourceMappingURL=JsonSchemaValidator.js.map

package/json/JsonSchemaValidator.js.map

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