@breadstone-infrastructure/prisma-seeds 0.0.231

package/ai/AISeedGenerator.js

@@ -0,0 +1,438 @@
+/* eslint-disable no-unused-vars */
+// #region Imports
+import { z } from 'zod';
+import { PrismaModelAnalyzer } from './PrismaModelAnalyzer.js';
+import { SeedLogger } from '../logging/SeedLogger.js';
+// #endregion
+/**
+ * AI-powered seed generator that uses LLMs to generate realistic test data.
+ *
+ * @public
+ */
+export class AISeedGenerator {
+    _prisma;
+    // #region Fields
+    _modelAnalyzer;
+    _logger = new SeedLogger();
+    // #endregion
+    // #region Ctor
+    constructor(_prisma) {
+        this._prisma = _prisma;
+        this._modelAnalyzer = new PrismaModelAnalyzer(_prisma);
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Generate entities using AI based on configuration.
+     *
+     * @public
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @param context Seed context with Prisma client and logger
+     * @param utilities Utilities for seeding operations
+     * @returns Result of the seeding operation
+     */
+    async generateEntities(config, context, utilities) {
+        if (!config.enabled) {
+            context.logger.info(`AI generation disabled for ${config.schema.modelName}`);
+            return utilities.createSeedResult(0, 0);
+        }
+        const { result: generatedEntities, duration } = await utilities.measureExecutionTime(async () => {
+            // 1. Analyze the Prisma model
+            const executionContext = await this._modelAnalyzer.analyzeModel(config.schema.modelName);
+            // 2. Prepare chunking configuration
+            const chunkSize = this.resolveChunkSize(config);
+            const totalCount = config.generation.count;
+            const totalChunks = Math.max(1, Math.ceil(totalCount / chunkSize));
+            const uniqueFieldTracker = this.initializeUniqueFieldTracker(config, executionContext);
+            const aggregatedEntities = new Array();
+            this._logger.info(`Preparing AI generation in ${totalChunks} chunk(s) with a maximum of ${chunkSize} entities per request.`);
+            for (let chunkIndex = 0; chunkIndex < totalChunks; chunkIndex++) {
+                const remaining = totalCount - aggregatedEntities.length;
+                if (remaining <= 0) {
+                    break;
+                }
+                const requestedCount = Math.min(chunkSize, remaining);
+                this._logger.debug(`Starting AI generation chunk ${chunkIndex + 1}/${totalChunks} targeting ${requestedCount} entities.`);
+                // 3. Generate AI prompt for the current chunk
+                const prompt = this.buildPrompt(config, executionContext, requestedCount, chunkIndex + 1, totalChunks);
+                // 4. Call AI to generate entities
+                const aiResult = await this.callAI(config, prompt, requestedCount);
+                // 5. Validate and transform data
+                const validatedData = this.validateAndTransform(aiResult, config, requestedCount, uniqueFieldTracker);
+                aggregatedEntities.push(...validatedData);
+                this._logger.info(`Chunk ${chunkIndex + 1}/${totalChunks} produced ${validatedData.length} valid entit${validatedData.length === 1 ? 'y' : 'ies'}.`);
+            }
+            if (aggregatedEntities.length < totalCount) {
+                this._logger.warn(`Requested ${totalCount} entit${totalCount === 1 ? 'y' : 'ies'} but only ${aggregatedEntities.length} valid entit${aggregatedEntities.length === 1 ? 'y was' : 'ies were'} generated.`);
+            }
+            // 6. Save to database
+            const savedEntities = await this.saveEntities(aggregatedEntities.slice(0, totalCount), config, context);
+            return savedEntities;
+        });
+        context.logger.info(`AI generated ${generatedEntities.length} ${config.schema.modelName} entities`);
+        return utilities.createSeedResult(generatedEntities.length, duration);
+    }
+    /**
+     * Build a comprehensive prompt for AI generation.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @param executionContext Execution context with model schema and existing data
+     * @returns The constructed prompt string
+     */
+    buildPrompt(config, executionContext, requestedCount, chunkIndex, totalChunks) {
+        const { generation, schema } = config;
+        if (config.promptTemplate) {
+            return this.interpolateTemplate(config.promptTemplate, {
+                config,
+                executionContext,
+                chunk: {
+                    current: chunkIndex,
+                    total: totalChunks,
+                    count: requestedCount
+                }
+            });
+        }
+        // Build default prompt
+        let prompt = `Generate ${requestedCount} realistic ${schema.modelName} entities for a fitness/nutrition application.\n\n`;
+        if (totalChunks > 1) {
+            prompt += `This is chunk ${chunkIndex} of ${totalChunks} to fulfil a total request of ${generation.count} entities. Avoid duplicating entries from earlier chunks and respect uniqueness constraints.\n\n`;
+        }
+        // Add context description
+        prompt += `Context: ${generation.description}\n\n`;
+        // Add schema information
+        prompt += 'Schema requirements:\n';
+        const fields = Object.entries(executionContext.modelSchema);
+        for (const [fieldName, fieldInfo] of fields) {
+            const info = fieldInfo;
+            prompt += `- ${fieldName}: ${info.type}${info.isRequired ? ' (required)' : ' (optional)'}${info.isUnique ? ' (must be unique)' : ''}\n`;
+        }
+        prompt += '\n';
+        // Add constraints
+        if (generation.constraints.length > 0) {
+            prompt += 'Constraints:\n';
+            for (const constraint of generation.constraints) {
+                prompt += `- ${constraint}\n`;
+            }
+            prompt += '\n';
+        }
+        // Add uniqueness requirements
+        if (generation.uniqueFields.length > 0) {
+            prompt += 'Unique fields (must not duplicate existing data):\n';
+            for (const field of generation.uniqueFields) {
+                const existingValues = this.getExistingFieldValues(executionContext.existingData, field);
+                prompt += `- ${field}: avoid [${existingValues.slice(0, 10).join(', ')}${existingValues.length > 10 ? '...' : ''}]\n`;
+            }
+            prompt += '\n';
+        }
+        // Add relationship context
+        if (generation.relationships.length > 0 && Object.keys(executionContext.relatedData).length > 0) {
+            prompt += 'Related data for references:\n';
+            for (const [modelName, data] of Object.entries(executionContext.relatedData)) {
+                const sampleIds = data.slice(0, 5).map((item) => item.id);
+                prompt += `- ${modelName} IDs: [${sampleIds.join(', ')}${data.length > 5 ? '...' : ''}]\n`;
+            }
+            prompt += '\n';
+        }
+        prompt += `Generate an array of ${requestedCount} objects that match this schema. `;
+        prompt += 'Ensure all data is realistic, diverse, and follows the constraints. ';
+        prompt += 'Return only valid JSON data.';
+        return prompt;
+    }
+    /**
+     * Call AI service to generate data.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @param prompt The prompt string to send to the AI
+     * @returns Array of generated objects
+     */
+    async callAI(config, prompt, requestedCount) {
+        const provider = this.createAIProvider(config.provider);
+        // Get or create Zod schema
+        const entitySchema = this.getZodSchema(config);
+        const minimumCount = Math.max(1, requestedCount);
+        const arraySchema = z.array(entitySchema)
+            .min(minimumCount)
+            .max(minimumCount * 2);
+        try {
+            // Dynamic import will be available when AI SDK is installed
+            const { generateObject } = await import('ai');
+            const result = await generateObject({
+                model: provider,
+                schema: arraySchema,
+                prompt: prompt
+            });
+            return result.object;
+        }
+        catch (error) {
+            throw new Error(`AI generation failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    resolveChunkSize(config) {
+        const { count, chunkSize } = config.generation;
+        if (chunkSize === undefined) {
+            return count;
+        }
+        const normalizedSize = Math.max(1, Math.floor(chunkSize));
+        return Math.min(normalizedSize, Math.max(1, count));
+    }
+    initializeUniqueFieldTracker(config, executionContext) {
+        const uniqueFields = config.generation.uniqueFields ?? [];
+        if (uniqueFields.length === 0) {
+            return undefined;
+        }
+        const tracker = new Map();
+        for (const field of uniqueFields) {
+            tracker.set(field, new Set());
+        }
+        const shouldIncludeExisting = config.generation.includeExistingData ?? true;
+        const existingDataSource = shouldIncludeExisting ? executionContext.existingData ?? [] : [];
+        for (const entry of existingDataSource) {
+            this.registerUniqueFieldValues(tracker, entry, uniqueFields);
+        }
+        return tracker;
+    }
+    hasDuplicateUniqueField(item, tracker, uniqueFields) {
+        if (item === null || typeof item !== 'object') {
+            return false;
+        }
+        const record = item;
+        for (const field of uniqueFields) {
+            const set = tracker.get(field);
+            if (!set) {
+                continue;
+            }
+            const normalizedValue = this.extractUniqueFieldValue(record[field]);
+            if (normalizedValue !== undefined && set.has(normalizedValue)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    registerUniqueFieldValues(tracker, item, uniqueFields) {
+        if (item === null || typeof item !== 'object') {
+            return;
+        }
+        const record = item;
+        for (const field of uniqueFields) {
+            const set = tracker.get(field);
+            if (!set) {
+                continue;
+            }
+            const normalizedValue = this.extractUniqueFieldValue(record[field]);
+            if (normalizedValue !== undefined) {
+                set.add(normalizedValue);
+            }
+        }
+    }
+    extractUniqueFieldValue(value) {
+        if (value === null || value === undefined) {
+            return undefined;
+        }
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (typeof value === 'object') {
+            try {
+                return JSON.stringify(value);
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return String(value);
+    }
+    /**
+     * Create AI provider based on configuration.
+     *
+     * @private
+     * @param provider The AI provider name
+     * @returns The corresponding environment variable key
+     */
+    createAIProvider(providerConfig) {
+        switch (providerConfig.provider) {
+            case 'openai': {
+                // Dynamic import to avoid dependency issues if not used
+                const { openai } = require('@ai-sdk/openai');
+                return openai(providerConfig.model, {
+                    apiKey: providerConfig.apiKey || process.env['OPENAI_API_KEY'],
+                    ...providerConfig.options
+                });
+            }
+            case 'anthropic': {
+                const { anthropic } = require('@ai-sdk/anthropic');
+                return anthropic(providerConfig.model, {
+                    apiKey: providerConfig.apiKey || process.env['ANTHROPIC_API_KEY'],
+                    ...providerConfig.options
+                });
+            }
+            case 'google': {
+                const { google } = require('@ai-sdk/google');
+                return google(providerConfig.model, {
+                    apiKey: providerConfig.apiKey || process.env['GOOGLE_API_KEY'],
+                    ...providerConfig.options
+                });
+            }
+            default:
+                throw new Error(`Unsupported AI provider: ${providerConfig.provider}`);
+        }
+    }
+    /**
+     * Validate generated data and apply transformations.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param data The raw generated data from AI
+     * @param config AI seed configuration
+     * @returns Array of validated and transformed entities
+     */
+    validateAndTransform(data, config, limit, uniqueFieldTracker) {
+        const validatedData = new Array();
+        const zodSchema = this.getZodSchema(config);
+        const uniqueFields = config.generation.uniqueFields ?? [];
+        for (const item of data) {
+            try {
+                // Validate with Zod schema
+                const validated = zodSchema.parse(item);
+                // Apply transformer if provided
+                const transformed = config.schema.transformer
+                    ? config.schema.transformer(validated)
+                    : validated;
+                if (uniqueFieldTracker && uniqueFields.length > 0) {
+                    if (this.hasDuplicateUniqueField(transformed, uniqueFieldTracker, uniqueFields)) {
+                        this._logger.warn('Duplicate detected for configured unique fields. Skipping generated item.');
+                        continue;
+                    }
+                    this.registerUniqueFieldValues(uniqueFieldTracker, transformed, uniqueFields);
+                }
+                validatedData.push(transformed);
+            }
+            catch (error) {
+                // Log validation errors but continue with other items
+                this._logger.warn(`Validation failed for generated item: ${error}`);
+            }
+            if (validatedData.length >= limit) {
+                break;
+            }
+        }
+        return validatedData;
+    }
+    /**
+     * Save generated entities to database.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param entities The array of entities to save
+     * @param config AI seed configuration
+     * @param context Seed context with Prisma client and logger
+     * @returns The saved entities
+     */
+    async saveEntities(entities, config, context) {
+        const modelName = this.toCamelCase(config.schema.modelName);
+        const modelDelegate = this._prisma[modelName];
+        if (!modelDelegate) {
+            throw new Error(`Model ${config.schema.modelName} not found in Prisma client`);
+        }
+        // Use transaction for consistency
+        return await this._prisma.$transaction(entities.map((entity) => modelDelegate.create({ data: entity })));
+    }
+    /**
+     * Get existing values for a field to avoid duplicates.
+     *
+     * @private
+     * @param existingData The existing data array
+     * @param fieldName The field name to extract values from
+     * @returns Array of existing values for the specified field
+     */
+    getExistingFieldValues(existingData, fieldName) {
+        return existingData
+            .map((item) => item?.[fieldName])
+            .filter((value) => value !== null && value !== undefined)
+            .map((value) => String(value));
+    }
+    /**
+     * Interpolate template with variables.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param template The template string with placeholders
+     * @param variables Variables to replace in the template
+     * @returns The interpolated string
+     */
+    interpolateTemplate(template, variables) {
+        // Simple template interpolation - can be enhanced with a proper template engine
+        let result = template;
+        const chunkInfo = variables.chunk;
+        // Replace common variables
+        result = result.replace(/\{\{count\}\}/g, String(chunkInfo?.count ?? variables.config.generation.count));
+        result = result.replace(/\{\{totalCount\}\}/g, String(variables.config.generation.count));
+        result = result.replace(/\{\{chunkIndex\}\}/g, String(chunkInfo?.current ?? 1));
+        result = result.replace(/\{\{chunkTotal\}\}/g, String(chunkInfo?.total ?? 1));
+        result = result.replace(/\{\{modelName\}\}/g, variables.config.schema.modelName);
+        result = result.replace(/\{\{description\}\}/g, variables.config.generation.description);
+        return result;
+    }
+    /**
+     * Convert model name to camelCase for Prisma client access.
+     *
+     * @private
+     * @param modelName The Prisma model name
+     * @returns The camelCased model name
+     */
+    toCamelCase(modelName) {
+        return modelName.charAt(0).toLowerCase() + modelName.slice(1);
+    }
+    /**
+     * Get or create Zod schema from config.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @returns Zod schema for validating generated entities
+     */
+    getZodSchema(config) {
+        if (config.schema.zodSchema) {
+            // Use provided Zod schema
+            return config.schema.zodSchema;
+        }
+        else {
+            // Auto-generate basic schema for common Prisma patterns
+            return this.generateBasicPrismaSchema(config.schema.modelName);
+        }
+    }
+    /**
+     * Generate a basic Zod schema for common Prisma model patterns.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @returns Zod schema for validating generated entities
+     */
+    generateBasicPrismaSchema(modelName) {
+        // Create a flexible schema that accepts common Prisma fields
+        const schema = z.object({
+            id: z.string().cuid()
+                .optional(),
+            createdAt: z.date().optional(),
+            updatedAt: z.date().optional(),
+            // Common fields based on model name patterns
+            ...modelName.toLowerCase() === 'user'
+                ? {
+                    email: z.string().email()
+                        .optional(),
+                    username: z.string().optional(),
+                    firstName: z.string().optional(),
+                    lastName: z.string().optional(),
+                    name: z.string().optional()
+                }
+                : {}
+            // Allow any additional fields for flexibility
+        }).passthrough();
+        return schema;
+    }
+}
+//# sourceMappingURL=AISeedGenerator.js.map

package/ai/AISeedGenerator.js.map

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

package/ai/AISeedTypes.d.ts

@@ -0,0 +1,138 @@
+import type { z } from 'zod';
+/**
+ * AI provider configuration for seed generation.
+ *
+ * @public
+ */
+export interface IAIProviderConfig {
+    /**
+     * The AI provider to use.
+     */
+    readonly provider: 'openai' | 'anthropic' | 'google' | 'custom';
+    /**
+     * The model to use for generation.
+     */
+    readonly model: string;
+    /**
+     * API key or configuration for the provider.
+     * Can be environment variable name or direct config.
+     */
+    readonly apiKey?: string;
+    /**
+     * Additional provider-specific options.
+     */
+    readonly options?: Record<string, unknown>;
+}
+/**
+ * Context and constraints for AI generation.
+ *
+ * @public
+ */
+export interface IAIGenerationContext {
+    /**
+     * Human-readable description of what data should be generated.
+     * Example: "Generate realistic user profiles for a fitness app"
+     */
+    readonly description: string;
+    /**
+     * Specific constraints and requirements.
+     * Example: ["unique email addresses", "realistic names", "varied ages 18-80"]
+     */
+    readonly constraints: readonly string[];
+    /**
+     * Fields that must be unique across all generated entities.
+     */
+    readonly uniqueFields: readonly string[];
+    /**
+     * Relationships to consider when generating data.
+     * Example: ["userId must reference existing users"]
+     */
+    readonly relationships: readonly string[];
+    /**
+     * Number of entities to generate.
+     */
+    readonly count: number;
+    /**
+     * Maximum number of entities to request per AI call.
+     * Enables sequential chunking to respect token limits of the provider.
+     */
+    readonly chunkSize?: number;
+    /**
+     * Whether to include existing data context for uniqueness validation.
+     */
+    readonly includeExistingData?: boolean;
+}
+/**
+ * Schema configuration for AI generation.
+ * Uses Prisma model type directly - no external dependencies needed in seed configs.
+ *
+ * @public
+ */
+export interface IAISeedSchema<T = unknown> {
+    /**
+     * Prisma model name this schema corresponds to.
+     */
+    readonly modelName: string;
+    /**
+     * Zod schema for validation - can be constructed using PrismaTypeSchemaGenerator.
+     * Pass undefined to auto-generate a basic schema based on common Prisma patterns.
+     */
+    readonly zodSchema?: z.ZodSchema<T>;
+    /**
+     * Optional transformer to convert generated data to Prisma input format.
+     * Receives the AI-generated data and returns data suitable for Prisma.create()
+     */
+    readonly transformer?: (data: T) => unknown;
+}
+/**
+ * Complete AI configuration for a seed.
+ *
+ * @public
+ */
+export interface IAISeedConfig<T = unknown> {
+    /**
+     * Whether AI generation is enabled for this seed.
+     */
+    readonly enabled: boolean;
+    /**
+     * AI provider configuration.
+     */
+    readonly provider: IAIProviderConfig;
+    /**
+     * Generation context and constraints.
+     */
+    readonly generation: IAIGenerationContext;
+    /**
+     * Schema for validation and type safety.
+     */
+    readonly schema: IAISeedSchema<T>;
+    /**
+     * Optional custom prompt template.
+     * If not provided, a default template based on schema and context will be used.
+     */
+    readonly promptTemplate?: string;
+}
+/**
+ * Context provided to AI seeders during execution.
+ *
+ * @public
+ */
+export interface IAISeedExecutionContext {
+    /**
+     * Prisma model schema information.
+     */
+    readonly modelSchema: Record<string, unknown>;
+    /**
+     * Existing data in the model for uniqueness checking.
+     */
+    readonly existingData: readonly unknown[];
+    /**
+     * Related data from other models.
+     */
+    readonly relatedData: Record<string, readonly unknown[]>;
+    /**
+     * Database constraints and indexes.
+     */
+    readonly constraints: Record<string, unknown>;
+}
+//# sourceMappingURL=AISeedTypes.d.ts.map

package/ai/AISeedTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AISeedTypes.d.ts","sourceRoot":"","sources":["../../src/ai/AISeedTypes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAEhE;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAE9C;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IAEjC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAE1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IAEtC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CAE/C;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IAEtC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAEpC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IAEpC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAEjD"}

package/ai/AISeedTypes.js

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

package/ai/AISeedTypes.js.map

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

package/ai/PrismaModelAnalyzer.d.ts

@@ -0,0 +1,36 @@
+import type { PrismaClient } from '@prisma/client';
+import type { IAISeedExecutionContext } from './AISeedTypes.js';
+/**
+ * Service for analyzing Prisma models and providing context for AI generation.
+ *
+ * @public
+ */
+export declare class PrismaModelAnalyzer {
+    private readonly _prisma;
+    constructor(_prisma: PrismaClient);
+    /**
+     * Analyze a Prisma model and extract schema information.
+     */
+    analyzeModel(modelName: string): Promise<IAISeedExecutionContext>;
+    /**
+     * Extract the schema definition for a Prisma model.
+     */
+    private _extractModelSchema;
+    /**
+     * Get existing data for uniqueness validation.
+     */
+    private _getExistingData;
+    /**
+     * Get related data from other models that this model references.
+     */
+    private _getRelatedData;
+    /**
+     * Get database constraints for the model.
+     */
+    private _getModelConstraints;
+    /**
+     * Convert model name to camelCase for Prisma client access.
+     */
+    private _toCamelCase;
+}
+//# sourceMappingURL=PrismaModelAnalyzer.d.ts.map

package/ai/PrismaModelAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismaModelAnalyzer.d.ts","sourceRoot":"","sources":["../../src/ai/PrismaModelAnalyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAIhE;;;;GAIG;AACH,qBAAa,mBAAmB;IAKxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY;IAO1C;;OAEG;IACU,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAc9E;;OAEG;YACW,mBAAmB;IAajC;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,eAAe;IA0B7B;;OAEG;YACW,oBAAoB;IAUlC;;OAEG;IACH,OAAO,CAAC,YAAY;CAMvB"}