@breadstone-infrastructure/prisma-seeds 0.0.231

package/json/JsonSeedLoader.d.ts

@@ -0,0 +1,33 @@
+import type { ISeedLogger } from '../logging/ISeedLogger.js';
+import type { IJsonSeedLoadOptions, IJsonValidationResult } from './JsonSeedTypes.js';
+/**
+ * Loader for JSON seed data files.
+ *
+ * @public
+ */
+export declare class JsonSeedLoader {
+    private readonly _fileSystem;
+    private readonly _logger;
+    private readonly _validator;
+    constructor(logger: ISeedLogger);
+    /**
+     * Load JSON files from the given sources (supports globs).
+     *
+     * @param sources File paths or glob patterns
+     * @param basePath Base path for resolving relative paths
+     * @returns Array of parsed JSON data
+     */
+    load(sources: string | readonly string[], basePath: string, options?: IJsonSeedLoadOptions): Promise<unknown[]>;
+    /**
+     * Load and validate JSON files against a schema.
+     *
+     * @param sources File paths or glob patterns
+     * @param schemaPath Path to JSON schema file
+     * @param basePath Base path for resolving relative paths
+     * @returns Validation result with data or errors
+     */
+    loadWithSchema(sources: string | readonly string[], schemaPath: string, basePath: string, options?: IJsonSeedLoadOptions): Promise<IJsonValidationResult>;
+    private _extractData;
+    private _extractByPath;
+}
+//# sourceMappingURL=JsonSeedLoader.d.ts.map

package/json/JsonSeedLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSeedLoader.d.ts","sourceRoot":"","sources":["../../src/json/JsonSeedLoader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAKtF;;;;GAIG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAM9B,MAAM,EAAE,WAAW;IAUtC;;;;;;OAMG;IACU,IAAI,CACb,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC;IAgCrB;;;;;;;OAOG;IACU,cAAc,CACvB,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IA2DjC,OAAO,CAAC,YAAY;IAqDpB,OAAO,CAAC,cAAc;CAuBzB"}

package/json/JsonSeedLoader.js

@@ -0,0 +1,176 @@
+// #region Imports
+import { FileSystem, Path } from '@breadstone-infrastructure/utilities';
+import { JsonSchemaValidator } from './JsonSchemaValidator.js';
+// #endregion
+/**
+ * Loader for JSON seed data files.
+ *
+ * @public
+ */
+export class JsonSeedLoader {
+    // #region Fields
+    _fileSystem;
+    _logger;
+    _validator;
+    // #endregion
+    // #region Ctor
+    constructor(logger) {
+        this._fileSystem = new FileSystem();
+        this._logger = logger;
+        this._validator = new JsonSchemaValidator(logger);
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Load JSON files from the given sources (supports globs).
+     *
+     * @param sources File paths or glob patterns
+     * @param basePath Base path for resolving relative paths
+     * @returns Array of parsed JSON data
+     */
+    async load(sources, basePath, options) {
+        const sourceArray = Array.isArray(sources) ? sources : [sources];
+        const allData = [];
+        const normalizedOptions = {
+            wrapperKeys: options?.wrapperKeys?.length
+                ? options.wrapperKeys
+                : undefined
+        };
+        for (const source of sourceArray) {
+            const absoluteSource = Path.isAbsolute(source) ? source : Path.combine(basePath, source);
+            const files = Path.glob(absoluteSource);
+            for (const file of files) {
+                try {
+                    const content = await this._fileSystem.fileReadAllText(file, 'utf-8');
+                    const parsed = JSON.parse(content);
+                    const extracted = this._extractData(parsed, normalizedOptions);
+                    if (extracted.length > 0) {
+                        allData.push(...extracted);
+                    }
+                }
+                catch (error) {
+                    this._logger.error(`Failed to load JSON from ${file}: ${error}`);
+                    throw error;
+                }
+            }
+        }
+        return allData;
+    }
+    /**
+     * Load and validate JSON files against a schema.
+     *
+     * @param sources File paths or glob patterns
+     * @param schemaPath Path to JSON schema file
+     * @param basePath Base path for resolving relative paths
+     * @returns Validation result with data or errors
+     */
+    async loadWithSchema(sources, schemaPath, basePath, options) {
+        try {
+            if (!schemaPath) {
+                const data = await this.load(sources, basePath, options);
+                return {
+                    isValid: true,
+                    errors: [],
+                    data
+                };
+            }
+            // Load raw JSON files without extraction first for validation
+            const sourceArray = Array.isArray(sources) ? sources : [sources];
+            const rawDocuments = [];
+            for (const source of sourceArray) {
+                const absoluteSource = Path.isAbsolute(source) ? source : Path.combine(basePath, source);
+                const files = Path.glob(absoluteSource);
+                for (const file of files) {
+                    try {
+                        const content = await this._fileSystem.fileReadAllText(file, 'utf-8');
+                        const parsed = JSON.parse(content);
+                        rawDocuments.push(parsed);
+                    }
+                    catch (error) {
+                        this._logger.error(`Failed to load JSON from ${file}: ${error}`);
+                        throw error;
+                    }
+                }
+            }
+            // Validate raw documents against schema
+            const absoluteSchemaPath = Path.isAbsolute(schemaPath)
+                ? schemaPath
+                : Path.combine(basePath, schemaPath);
+            const validationResult = this._validator.validate(rawDocuments, absoluteSchemaPath);
+            if (!validationResult.isValid) {
+                return validationResult;
+            }
+            // Now extract the actual data items
+            const data = await this.load(sources, basePath, options);
+            return {
+                isValid: true,
+                errors: [],
+                data
+            };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                errors: [String(error)],
+                data: undefined
+            };
+        }
+    }
+    _extractData(data, options) {
+        if (Array.isArray(data)) {
+            return data;
+        }
+        if (!data || typeof data !== 'object') {
+            return data === undefined ? [] : [data];
+        }
+        const candidate = data;
+        const wrapperKeys = options.wrapperKeys;
+        if (wrapperKeys && wrapperKeys.length > 0) {
+            const extracted = [];
+            for (const wrapperKey of wrapperKeys) {
+                const value = this._extractByPath(candidate, wrapperKey);
+                if (Array.isArray(value)) {
+                    extracted.push(...value);
+                }
+                else if (value !== undefined) {
+                    extracted.push(value);
+                }
+            }
+            if (extracted.length > 0) {
+                return extracted;
+            }
+            this._logger.warn(`Wrapper key(s) ${wrapperKeys.join(', ')} not found in JSON payload. Falling back to default extraction.`);
+        }
+        if ('items' in candidate && Array.isArray(candidate['items'])) {
+            return candidate['items'];
+        }
+        if ('recipes' in candidate && Array.isArray(candidate['recipes'])) {
+            return candidate['recipes'];
+        }
+        if ('exercises' in candidate && Array.isArray(candidate['exercises'])) {
+            return candidate['exercises'];
+        }
+        if ('tips' in candidate && Array.isArray(candidate['tips'])) {
+            return candidate['tips'];
+        }
+        return [candidate];
+    }
+    _extractByPath(source, path) {
+        const segments = path.split('.').map((segment) => segment.trim())
+            .filter((segment) => segment.length > 0);
+        if (segments.length === 0) {
+            return undefined;
+        }
+        let current = source;
+        for (const segment of segments) {
+            if (current && typeof current === 'object' && segment in current) {
+                current = current[segment];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return current;
+    }
+}
+//# sourceMappingURL=JsonSeedLoader.js.map

package/json/JsonSeedLoader.js.map

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

package/json/JsonSeedTypes.d.ts

@@ -0,0 +1,204 @@
+import type { ISeedContext } from '../config/ISeedContext.js';
+/**
+ * Configuration for a JSON-based seeder.
+ *
+ * @template TJson The shape of the JSON data
+ * @template TPrisma The Prisma create input type
+ * @public
+ */
+export interface IJsonSeedConfig<TJson = unknown, TPrisma = unknown> {
+    /**
+     * Unique name for this JSON seeder.
+     *
+     * @readonly
+     */
+    readonly name: string;
+    /**
+     * Path(s) to JSON data files (supports glob patterns).
+     * Relative to the seed.config.mjs location.
+     *
+     * @readonly
+     */
+    readonly sources: string | readonly string[];
+    /**
+     * Optional key (or keys) selecting the array within the JSON payload that should
+     * be processed. Supports nested access via dot-notation.
+     *
+     * @readonly
+     */
+    readonly wrapperKey?: string | readonly string[];
+    /**
+     * Optional JSON Schema path for validation.
+     * If omitted, no schema validation is performed.
+     *
+     * @readonly
+     */
+    readonly schema?: string;
+    /**
+     * Prisma model name (e.g., 'recipe', 'exercise').
+     *
+     * @readonly
+     */
+    readonly model: string;
+    /**
+     * Mapper to transform JSON data to Prisma create input.
+     * If omitted, assumes JSON structure matches Prisma exactly.
+     *
+     * @readonly
+     */
+    readonly mapper?: IJsonSeedMapper<TJson, TPrisma>;
+    /**
+     * Optional reference resolver configuration.
+     *
+     * @readonly
+     */
+    readonly references?: IJsonReferenceConfig;
+    /**
+     * Upsert strategy configuration.
+     *
+     * @readonly
+     */
+    readonly upsert?: {
+        /**
+         * Field(s) to use for identifying existing records.
+         */
+        readonly uniqueFields: string | readonly string[];
+        /**
+         * Whether to update existing records (default: false).
+         */
+        readonly updateExisting?: boolean;
+    };
+    /**
+     * Batch processing configuration.
+     *
+     * @readonly
+     */
+    readonly batch?: {
+        /**
+         * Number of items to process in a single batch.
+         */
+        readonly size?: number;
+        /**
+         * Whether to use transactions for batches.
+         */
+        readonly useTransaction?: boolean;
+    };
+    /**
+     * Whether this seeder is enabled.
+     *
+     * @readonly
+     */
+    readonly enabled?: boolean;
+}
+/**
+ * Mapper interface for transforming JSON to Prisma input.
+ *
+ * @template TJson The JSON input type
+ * @template TPrisma The Prisma output type
+ * @public
+ */
+export interface IJsonSeedMapper<TJson, TPrisma> {
+    /**
+     * Transform JSON data to Prisma create input.
+     *
+     * @param data The JSON data
+     * @param context The seed context
+     * @returns The Prisma create input
+     */
+    mapToCreate(_data: TJson, _context: ISeedContext): Promise<TPrisma> | TPrisma;
+    /**
+     * Optional: Transform for update operations.
+     *
+     * @param data The JSON data
+     * @param existing The existing record
+     * @param context The seed context
+     * @returns The Prisma update input
+     */
+    mapToUpdate?(_data: TJson, _existing: unknown, _context: ISeedContext): Promise<TPrisma> | TPrisma;
+    /**
+     * Optional: Pre-process JSON before mapping.
+     *
+     * @param data The JSON data
+     * @param context The seed context
+     * @returns The processed JSON data
+     */
+    preProcess?(_data: TJson, _context: ISeedContext): Promise<TJson> | TJson;
+}
+/**
+ * Options controlling how JSON seed files are loaded.
+ *
+ * @public
+ */
+export interface IJsonSeedLoadOptions {
+    /**
+     * Specific keys that should be extracted from the JSON payload.
+     * Accepts a single key or a list of keys (dot-notation supported).
+     */
+    readonly wrapperKeys?: readonly string[];
+}
+/**
+ * Reference resolution configuration.
+ *
+ * @public
+ */
+export interface IJsonReferenceConfig {
+    /**
+     * Prefix for reference syntax (default: '@ref:').
+     *
+     * @readonly
+     */
+    readonly prefix?: string;
+    /**
+     * Prefix for asset references (default: '@asset:').
+     *
+     * @readonly
+     */
+    readonly assetPrefix?: string;
+    /**
+     * Custom resolvers for specific reference types.
+     *
+     * @readonly
+     */
+    readonly resolvers?: Record<string, IJsonReferenceResolver>;
+}
+/**
+ * Resolver for a specific reference type.
+ *
+ * @public
+ */
+export interface IJsonReferenceResolver {
+    /**
+     * Resolve a reference key to an actual value (usually an ID).
+     *
+     * @param key The reference key
+     * @param context The seed context
+     * @returns The resolved value
+     */
+    resolve(_key: string, _context: ISeedContext): Promise<string | number>;
+}
+/**
+ * Validation result from JSON schema validation.
+ *
+ * @public
+ */
+export interface IJsonValidationResult {
+    /**
+     * Whether the validation was successful.
+     *
+     * @readonly
+     */
+    readonly isValid: boolean;
+    /**
+     * Validation errors if any.
+     *
+     * @readonly
+     */
+    readonly errors: readonly string[];
+    /**
+     * Validated data if successful.
+     *
+     * @readonly
+     */
+    readonly data?: unknown;
+}
+//# sourceMappingURL=JsonSeedTypes.d.ts.map

package/json/JsonSeedTypes.d.ts.map

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

package/json/JsonSeedTypes.js

@@ -0,0 +1,3 @@
+// #region Imports
+export {};
+//# sourceMappingURL=JsonSeedTypes.js.map

package/json/JsonSeedTypes.js.map

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

package/json/createJsonSeeder.d.ts

@@ -0,0 +1,13 @@
+import type { IJsonSeedConfig } from './JsonSeedTypes.js';
+import type { ISeeder } from '../config/ISeeder.js';
+/**
+ * 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 declare function createJsonSeeder<TJson = unknown, TPrisma = unknown>(config: IJsonSeedConfig<TJson, TPrisma>): ISeeder;
+//# sourceMappingURL=createJsonSeeder.d.ts.map

package/json/createJsonSeeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createJsonSeeder.d.ts","sourceRoot":"","sources":["../../src/json/createJsonSeeder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAUpD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC/D,MAAM,EAAE,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,GACxC,OAAO,CA0QT"}