ai-database 2.1.3 → 2.3.0

package/dist/schema/value-generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/value-generators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAcH,4BAA4B;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAI1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE1C,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF,wCAAwC;AACxC,IAAI,gBAAgB,GAA0B,IAAI,CAAA;AAElD,4BAA4B;AAC5B,IAAI,aAAa,GAAyB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAA+B,EAAE;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,aAAa,CAAA;IAEzC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;QAC/E,CAAC;QACD,MAAM,QAAQ,GAA6C;YACzD,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAA;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;QAC7D,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;YAAE,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;QACzE,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;QAC/E,IAAI,MAAM,CAAC,qBAAqB,KAAK,SAAS;YAC5C,QAAQ,CAAC,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAA;QAC/D,OAAO,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,IAAI,yBAAyB,EAAE,CAAA;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA4B;IAClE,aAAa,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAC7B,gBAAgB,GAAG,IAAI,CAAA,CAAC,yDAAyD;AACnF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,SAAiB,EACjB,IAAY,EACZ,WAAmB,EACnB,IAAwB,EACxB,aAAsC,EAAE;IAExC,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAA;IACrC,MAAM,OAAO,GAA2C;QACtD,SAAS;QACT,IAAI;QACJ,WAAW;QACX,UAAU;KACX,CAAA;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA;IAC3C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAChD,OAAO,MAAM,CAAC,KAAK,CAAA;AACrB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,6BAA6B,CAC3C,SAAiB,EACjB,IAAY,EACZ,WAAmB,EACnB,IAAwB,EACxB,aAAsC,EAAE;IAExC,oDAAoD;IACpD,MAAM,SAAS,GAAG,IAAI,yBAAyB,EAAE,CAAA;IACjD,qEAAqE;IACrE,sEAAsE;IACtE,MAAM,OAAO,GAA2C;QACtD,SAAS;QACT,IAAI;QACJ,WAAW;QACX,UAAU;KACX,CAAA;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA;IAE3C,qEAAqE;IACrE,mEAAmE;IACnE,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1C,MAAM,GAAG,CAAC,CAAC,KAAK,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,sDAAsD;IACtD,iEAAiE;IACjE,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;QACvC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9C,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;IAC7C,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,EAAE,CAAA;IAC9C,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IAE5C,oDAAoD;IACpD,6CAA6C;IAC7C,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC3E,OAAO,WAAW,CAAA;QACpB,IAAI,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,WAAW,CAAA;QAChG,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,GAAG,IAAI,KAAK,IAAI,EAAE,CAAA;QAClD,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;IAC7C,CAAC;IAED,6CAA6C;IAC7C,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;AACvC,CAAC"}

package/dist/schema/value-generators/placeholder.d.ts

@@ -0,0 +1,52 @@
+/**
+ * PlaceholderValueGenerator Implementation
+ *
+ * Provides deterministic, context-aware placeholder values for testing.
+ * This generator uses keyword matching on context and hints to produce
+ * appropriate values for common field names.
+ *
+ * **PURPOSE**: This is a test fixture generator that provides:
+ * - Deterministic, predictable outputs for testing
+ * - Expected behavior and API contract demonstration
+ * - Specific assertions about generated content
+ *
+ * In production, the AIValueGenerator would be used instead.
+ *
+ * @packageDocumentation
+ */
+import type { ValueGenerator, GenerationRequest, GenerationResult } from './types.js';
+/**
+ * PlaceholderValueGenerator
+ *
+ * Generates deterministic values based on field name and context keywords.
+ * Used for testing and development when AI generation is not needed.
+ */
+export declare class PlaceholderValueGenerator implements ValueGenerator {
+    /**
+     * Generate a context-aware placeholder value
+     *
+     * Uses keyword matching on the context and hint to produce contextually
+     * relevant values for common field names.
+     *
+     * @param request - The generation request
+     * @returns Promise resolving to the generated value with metadata
+     */
+    generate(request: GenerationRequest): Promise<GenerationResult>;
+    /**
+     * Synchronous value generation
+     *
+     * This is the core generation logic, exposed for callers that need
+     * synchronous operation (e.g., backward-compatible cascade.ts).
+     *
+     * @param request - The generation request
+     * @returns The generated value string
+     */
+    generateSync(request: GenerationRequest): string;
+    /**
+     * Core value generation logic
+     *
+     * Moved from cascade.ts generateContextAwareValue function.
+     */
+    private generateValue;
+}
+//# sourceMappingURL=placeholder.d.ts.map

package/dist/schema/value-generators/placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../../src/schema/value-generators/placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAErF;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D;;;;;;;;OAQG;IACG,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQrE;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAIhD;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAgTtB"}

package/dist/schema/value-generators/placeholder.js

@@ -0,0 +1,328 @@
+/**
+ * PlaceholderValueGenerator Implementation
+ *
+ * Provides deterministic, context-aware placeholder values for testing.
+ * This generator uses keyword matching on context and hints to produce
+ * appropriate values for common field names.
+ *
+ * **PURPOSE**: This is a test fixture generator that provides:
+ * - Deterministic, predictable outputs for testing
+ * - Expected behavior and API contract demonstration
+ * - Specific assertions about generated content
+ *
+ * In production, the AIValueGenerator would be used instead.
+ *
+ * @packageDocumentation
+ */
+/**
+ * PlaceholderValueGenerator
+ *
+ * Generates deterministic values based on field name and context keywords.
+ * Used for testing and development when AI generation is not needed.
+ */
+export class PlaceholderValueGenerator {
+    /**
+     * Generate a context-aware placeholder value
+     *
+     * Uses keyword matching on the context and hint to produce contextually
+     * relevant values for common field names.
+     *
+     * @param request - The generation request
+     * @returns Promise resolving to the generated value with metadata
+     */
+    async generate(request) {
+        const value = this.generateValue(request);
+        return {
+            value,
+            metadata: { source: 'placeholder' },
+        };
+    }
+    /**
+     * Synchronous value generation
+     *
+     * This is the core generation logic, exposed for callers that need
+     * synchronous operation (e.g., backward-compatible cascade.ts).
+     *
+     * @param request - The generation request
+     * @returns The generated value string
+     */
+    generateSync(request) {
+        return this.generateValue(request);
+    }
+    /**
+     * Core value generation logic
+     *
+     * Moved from cascade.ts generateContextAwareValue function.
+     */
+    generateValue(request) {
+        const { fieldName, type, fullContext, hint, parentData = {} } = request;
+        // If parent has the same field, copy its value (for self-referential types like Company.competitor)
+        const parentValue = parentData[fieldName];
+        if (typeof parentValue === 'string' && parentValue) {
+            return parentValue;
+        }
+        const contextLower = (fullContext || '').toLowerCase();
+        const hintLower = (hint || '').toLowerCase();
+        // For 'name' field, use hint-based generation with keyword matching
+        // Note: hint takes priority, check hint first before context
+        if (fieldName === 'name') {
+            if (hintLower.includes('philosopher') || contextLower.includes('philosopher'))
+                return 'Aristotle';
+            if (hintLower.includes('tech entrepreneur') || hintLower.includes('startup'))
+                return 'Alex Chen';
+            if (hint && hint.trim())
+                return `${type}: ${hint}`;
+            // Fall back to static placeholder if no context or hint
+            if (!fullContext || fullContext.trim() === '') {
+                return `Generated ${fieldName} for ${type}`;
+            }
+            return `Generated ${fieldName} for ${type}`;
+        }
+        // For 'style' field
+        if (fieldName === 'style') {
+            if (hintLower.includes('energetic') || contextLower.includes('energetic'))
+                return 'Energetic and engaging presentation style';
+            if (contextLower.includes('horror') || contextLower.includes('dark'))
+                return 'Dark and atmospheric horror style';
+            if (contextLower.includes('sci-fi') || contextLower.includes('futuristic'))
+                return 'Atmospheric sci-fi suspense style';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'background' field
+        if (fieldName === 'background') {
+            if (hintLower.includes('tech entrepreneur') || hintLower.includes('startup'))
+                return 'Tech startup founder with 10 years experience';
+            if (hintLower.includes('aristocrat') || hintLower.includes('noble'))
+                return 'English aristocrat from old noble family';
+            if (contextLower.includes('renewable') || contextLower.includes('energy'))
+                return 'Background in renewable energy sector';
+            if (!fullContext || fullContext.trim() === '') {
+                return `Generated ${fieldName} for ${type}`;
+            }
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'specialty' field - hint takes priority over context
+        if (fieldName === 'specialty') {
+            // Check hint first for priority
+            if (hintLower.includes('security'))
+                return 'Security and authentication systems';
+            if (hintLower.includes('history') || hintLower.includes('medieval'))
+                return 'Medieval history specialist';
+            // Then check context
+            if (contextLower.includes('french') || contextLower.includes('restaurant'))
+                return 'French classical cuisine';
+            if (contextLower.includes('security'))
+                return 'Security and authentication systems';
+            if (!fullContext || fullContext.trim() === '') {
+                return `Generated ${fieldName} for ${type}`;
+            }
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'training' field
+        if (fieldName === 'training') {
+            if (contextLower.includes('french') || contextLower.includes('restaurant'))
+                return 'Trained in classical French culinary techniques';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'backstory' field
+        if (fieldName === 'backstory') {
+            if (contextLower.includes('medieval') || contextLower.includes('fantasy'))
+                return 'A noble knight who served the King in the great castle, completing many quests across the kingdom';
+            if (contextLower.includes('sci-fi') || contextLower.includes('space'))
+                return 'A starship captain with years of deep space exploration';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'headline' field
+        if (fieldName === 'headline') {
+            // Check for name mentions in context for personalized headlines
+            if (contextLower.includes('codehelper'))
+                return 'CodeHelper: Dev Tools';
+            if (contextLower.includes('techcorp'))
+                return 'TechCorp Solutions';
+            if (contextLower.includes('software engineer'))
+                return 'For Dev Teams';
+            if (contextLower.includes('tech') || contextLower.includes('startup'))
+                return 'Tech Startup Solutions';
+            return `Headline for ${type}`.slice(0, 30);
+        }
+        // For 'copy' field
+        if (fieldName === 'copy') {
+            if (contextLower.includes('tech') || contextLower.includes('startup'))
+                return 'Innovative tech solutions for startups and growing companies';
+            if (contextLower.includes('marketing') || contextLower.includes('campaign'))
+                return 'Effective marketing campaign for tech launch';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'tagline' field
+        if (fieldName === 'tagline') {
+            if (contextLower.includes('luxury') || contextLower.includes('premium'))
+                return 'Luxury craftsmanship meets elegant design';
+            if (contextLower.includes('quality') || contextLower.includes('craftsmanship'))
+                return 'Premium quality with expert craftsmanship';
+            if (contextLower.includes('tech'))
+                return 'Technology for the future';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'description' field
+        if (fieldName === 'description') {
+            if (contextLower.includes('cyberpunk') ||
+                contextLower.includes('neon') ||
+                contextLower.includes('futuristic'))
+                return 'Cyberpunk character with neural augmentations';
+            if (contextLower.includes('luxury') ||
+                contextLower.includes('high-end') ||
+                contextLower.includes('premium'))
+                return 'A luxury premium product with elegant craftsmanship';
+            if (contextLower.includes('enterprise') || contextLower.includes('b2b'))
+                return 'Enterprise solution for business customers';
+            if (contextLower.includes('nurse') || contextLower.includes('healthcare'))
+                return 'Healthcare documentation solution for nurses and medical staff';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'abilities' field
+        if (fieldName === 'abilities') {
+            if (contextLower.includes('cyberpunk') || contextLower.includes('futuristic'))
+                return 'Neural hacking and digital infiltration';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'method' field
+        if (fieldName === 'method') {
+            if (hintLower.includes('wit') || hintLower.includes('sharp'))
+                return 'Brilliant deduction and clever observation';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'expertise' field - check hint first, then context
+        if (fieldName === 'expertise') {
+            // Check hint first for priority
+            if (hintLower.includes('machine learning') ||
+                hintLower.includes('medical') ||
+                hintLower.includes('ai'))
+                return 'Machine learning for medical applications';
+            if (hintLower.includes('physics') || hintLower.includes('professor'))
+                return 'Physics professor specializing in quantum mechanics';
+            if (hintLower.includes('journalist') || hintLower.includes('science'))
+                return 'Science journalist covering physics research';
+            // Then check context
+            if (contextLower.includes('machine learning') ||
+                contextLower.includes('medical') ||
+                contextLower.includes('ai'))
+                return 'Machine learning for medical applications';
+            if (!fullContext || fullContext.trim() === '') {
+                return `Generated ${fieldName} for ${type}`;
+            }
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'focus' field
+        if (fieldName === 'focus') {
+            if (contextLower.includes('renewable') ||
+                contextLower.includes('energy') ||
+                contextLower.includes('green'))
+                return 'Focus on sustainable energy transformation';
+            if (contextLower.includes('tech') || contextLower.includes('programming'))
+                return 'Focus on technical programming topics';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'qualifications' field
+        if (fieldName === 'qualifications') {
+            if (contextLower.includes('astrophysics') ||
+                contextLower.includes('astronomy') ||
+                contextLower.includes('space'))
+                return 'PhD in Astrophysics from MIT';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'teachingStyle' field
+        if (fieldName === 'teachingStyle') {
+            if (contextLower.includes('beginner') || contextLower.includes('introduct'))
+                return 'Patient and accessible approach for beginners';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'experience' field
+        if (fieldName === 'experience') {
+            if (contextLower.includes('horror') || contextLower.includes('film'))
+                return 'Experience in horror film production';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'role' field
+        if (fieldName === 'role') {
+            if (hintLower.includes('research') ||
+                hintLower.includes('machine learning') ||
+                hintLower.includes('phd'))
+                return 'Machine learning researcher';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'portfolio' field
+        if (fieldName === 'portfolio') {
+            if (hintLower.includes('award') ||
+                hintLower.includes('beaux-arts') ||
+                hintLower.includes('ecole'))
+                return 'Award-winning design portfolio from Beaux-Arts';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'challenges' field
+        if (fieldName === 'challenges') {
+            if (contextLower.includes('enterprise') || contextLower.includes('software'))
+                return 'Budget constraints and decision-making complexity in enterprise software procurement';
+            if (contextLower.includes('startup') || contextLower.includes('tech'))
+                return 'Scaling challenges and market competition in tech startup growth';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'severity' field - return one of the enum options
+        if (fieldName === 'severity') {
+            // Check hint for enum options like 'low/medium/high'
+            if (hintLower.includes('low') || hintLower.includes('medium') || hintLower.includes('high')) {
+                // Return a contextually appropriate severity
+                if (contextLower.includes('critical') || contextLower.includes('urgent'))
+                    return 'high';
+                if (contextLower.includes('minor') || contextLower.includes('small'))
+                    return 'low';
+                return 'medium'; // default to medium
+            }
+            return 'medium';
+        }
+        // For 'effort' field - return one of the enum options
+        if (fieldName === 'effort') {
+            if (hintLower.includes('easy') ||
+                hintLower.includes('medium') ||
+                hintLower.includes('hard')) {
+                if (contextLower.includes('simple') || contextLower.includes('quick'))
+                    return 'easy';
+                if (contextLower.includes('complex') || contextLower.includes('difficult'))
+                    return 'hard';
+                return 'medium';
+            }
+            return 'medium';
+        }
+        // For 'level' field - return one of the enum options
+        if (fieldName === 'level') {
+            if (hintLower.includes('beginner') ||
+                hintLower.includes('intermediate') ||
+                hintLower.includes('expert')) {
+                if (contextLower.includes('beginner') || contextLower.includes('basic'))
+                    return 'beginner';
+                if (contextLower.includes('expert') || contextLower.includes('advanced'))
+                    return 'expert';
+                return 'intermediate';
+            }
+            return 'intermediate';
+        }
+        // For 'persona' field
+        if (fieldName === 'persona') {
+            if (contextLower.includes('enterprise') || contextLower.includes('software'))
+                return 'Enterprise software buyer persona';
+            if (contextLower.includes('tech') || contextLower.includes('startup'))
+                return 'Tech-savvy startup founder persona';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // For 'jobTitle' field
+        if (fieldName === 'jobTitle') {
+            if (contextLower.includes('enterprise') || contextLower.includes('software'))
+                return 'VP of Engineering';
+            if (contextLower.includes('tech') || contextLower.includes('startup'))
+                return 'CTO';
+            return `${fieldName}: ${fullContext}`;
+        }
+        // Default: include context in the generated value
+        return `${fieldName}: ${fullContext}`;
+    }
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/schema/value-generators/placeholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../../src/schema/value-generators/placeholder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA0B;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QACzC,OAAO;YACL,KAAK;YACL,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;SACpC,CAAA;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,OAA0B;QACrC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED;;;;OAIG;IACK,aAAa,CAAC,OAA0B;QAC9C,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,CAAA;QAEvE,oGAAoG;QACpG,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;QACzC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,EAAE,CAAC;YACnD,OAAO,WAAW,CAAA;QACpB,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QACtD,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QAE5C,oEAAoE;QACpE,6DAA6D;QAC7D,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC3E,OAAO,WAAW,CAAA;YACpB,IAAI,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC1E,OAAO,WAAW,CAAA;YACpB,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;gBAAE,OAAO,GAAG,IAAI,KAAK,IAAI,EAAE,CAAA;YAClD,wDAAwD;YACxD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC9C,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;YAC7C,CAAC;YACD,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;QAC7C,CAAC;QAED,oBAAoB;QACpB,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACvE,OAAO,2CAA2C,CAAA;YACpD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAClE,OAAO,mCAAmC,CAAA;YAC5C,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACxE,OAAO,mCAAmC,CAAA;YAC5C,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,yBAAyB;QACzB,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;YAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC1E,OAAO,+CAA+C,CAAA;YACxD,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACjE,OAAO,0CAA0C,CAAA;YACnD,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACvE,OAAO,uCAAuC,CAAA;YAChD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC9C,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;YAC7C,CAAC;YACD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,2DAA2D;QAC3D,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC9B,gCAAgC;YAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO,qCAAqC,CAAA;YAChF,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACjE,OAAO,6BAA6B,CAAA;YACtC,qBAAqB;YACrB,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACxE,OAAO,0BAA0B,CAAA;YACnC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO,qCAAqC,CAAA;YACnF,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC9C,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;YAC7C,CAAC;YACD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,uBAAuB;QACvB,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACxE,OAAO,iDAAiD,CAAA;YAC1D,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,wBAAwB;QACxB,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC9B,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACvE,OAAO,mGAAmG,CAAA;YAC5G,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACnE,OAAO,yDAAyD,CAAA;YAClE,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,uBAAuB;QACvB,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,gEAAgE;YAChE,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAE,OAAO,uBAAuB,CAAA;YACvE,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAE,OAAO,oBAAoB,CAAA;YAClE,IAAI,YAAY,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBAAE,OAAO,eAAe,CAAA;YACtE,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACnE,OAAO,wBAAwB,CAAA;YACjC,OAAO,gBAAgB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAC5C,CAAC;QAED,mBAAmB;QACnB,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACnE,OAAO,8DAA8D,CAAA;YACvE,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACzE,OAAO,8CAA8C,CAAA;YACvD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,sBAAsB;QACtB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACrE,OAAO,2CAA2C,CAAA;YACpD,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAC5E,OAAO,2CAA2C,CAAA;YACpD,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAO,2BAA2B,CAAA;YACrE,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,0BAA0B;QAC1B,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;YAChC,IACE,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAClC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC7B,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAEnC,OAAO,+CAA+C,CAAA;YACxD,IACE,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/B,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBACjC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAEhC,OAAO,qDAAqD,CAAA;YAC9D,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACrE,OAAO,4CAA4C,CAAA;YACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACvE,OAAO,gEAAgE,CAAA;YACzE,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,wBAAwB;QACxB,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC9B,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC3E,OAAO,yCAAyC,CAAA;YAClD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,qBAAqB;QACrB,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC1D,OAAO,4CAA4C,CAAA;YACrD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,yDAAyD;QACzD,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC9B,gCAAgC;YAChC,IACE,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACtC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC7B,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAExB,OAAO,2CAA2C,CAAA;YACpD,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAClE,OAAO,qDAAqD,CAAA;YAC9D,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACnE,OAAO,8CAA8C,CAAA;YACvD,qBAAqB;YACrB,IACE,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACzC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAChC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAE3B,OAAO,2CAA2C,CAAA;YACpD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC9C,OAAO,aAAa,SAAS,QAAQ,IAAI,EAAE,CAAA;YAC7C,CAAC;YACD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,oBAAoB;QACpB,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,IACE,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAClC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC/B,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAE9B,OAAO,4CAA4C,CAAA;YACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC;gBACvE,OAAO,uCAAuC,CAAA;YAChD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,6BAA6B;QAC7B,IAAI,SAAS,KAAK,gBAAgB,EAAE,CAAC;YACnC,IACE,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACrC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAClC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAE9B,OAAO,8BAA8B,CAAA;YACvC,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,4BAA4B;QAC5B,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;YAClC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACzE,OAAO,+CAA+C,CAAA;YACxD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,yBAAyB;QACzB,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;YAC/B,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAClE,OAAO,sCAAsC,CAAA;YAC/C,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,mBAAmB;QACnB,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,IACE,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC9B,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACtC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAEzB,OAAO,6BAA6B,CAAA;YACtC,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,wBAAwB;QACxB,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC9B,IACE,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC3B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAChC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAE3B,OAAO,gDAAgD,CAAA;YACzD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,yBAAyB;QACzB,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;YAC/B,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC1E,OAAO,sFAAsF,CAAA;YAC/F,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACnE,OAAO,kEAAkE,CAAA;YAC3E,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,wDAAwD;QACxD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,qDAAqD;YACrD,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5F,6CAA6C;gBAC7C,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,OAAO,MAAM,CAAA;gBACvF,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,KAAK,CAAA;gBAClF,OAAO,QAAQ,CAAA,CAAC,oBAAoB;YACtC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,sDAAsD;QACtD,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,IACE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC1B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC5B,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC1B,CAAC;gBACD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,MAAM,CAAA;gBACpF,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC;oBAAE,OAAO,MAAM,CAAA;gBACzF,OAAO,QAAQ,CAAA;YACjB,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,qDAAqD;QACrD,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,IACE,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC9B,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC5B,CAAC;gBACD,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,UAAU,CAAA;gBAC1F,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAAE,OAAO,QAAQ,CAAA;gBACzF,OAAO,cAAc,CAAA;YACvB,CAAC;YACD,OAAO,cAAc,CAAA;QACvB,CAAC;QAED,sBAAsB;QACtB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC1E,OAAO,mCAAmC,CAAA;YAC5C,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACnE,OAAO,oCAAoC,CAAA;YAC7C,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,uBAAuB;QACvB,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC1E,OAAO,mBAAmB,CAAA;YAC5B,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,KAAK,CAAA;YACnF,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;QACvC,CAAC;QAED,kDAAkD;QAClD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAA;IACvC,CAAC;CACF"}

package/dist/schema/value-generators/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * ValueGenerator Type Definitions
+ *
+ * Defines the interface for value generation strategies used during
+ * entity creation. Supports both placeholder (deterministic test fixtures)
+ * and AI-powered (production) generation.
+ *
+ * @packageDocumentation
+ */
+import type { Entity } from '../generation-context.js';
+/**
+ * Context about the array field being generated
+ */
+export interface ArrayContext {
+    /** The name of the array field */
+    fieldName: string;
+    /** Previously generated items in this array */
+    previousItems: Entity[];
+    /** Current index being generated */
+    index: number;
+}
+/**
+ * Extended generation context from GenerationContext
+ */
+export interface GenerationContextData {
+    /** Chain of parent entities leading to this entity */
+    parentChain?: Entity[];
+    /** All entities previously generated in this session */
+    previouslyGenerated?: Entity[];
+    /** Context for array field generation */
+    arrayContext?: ArrayContext;
+}
+/**
+ * Request for generating a field value
+ */
+export interface GenerationRequest {
+    /** Name of the field being generated */
+    fieldName: string;
+    /** Entity type name */
+    type: string;
+    /** Combined context string (instructions, parent data, etc.) */
+    fullContext?: string;
+    /** Optional hint for guiding generation (e.g., prompt field type) */
+    hint?: string;
+    /** Data from parent entity for context inheritance */
+    parentData?: Record<string, unknown>;
+    /** Extended generation context with parent chain and array info */
+    generationContext?: GenerationContextData;
+}
+/**
+ * Metadata about how the value was generated
+ */
+export interface GenerationMetadata {
+    /** Source of the generated value */
+    source: 'placeholder' | 'ai' | 'test';
+    /** Model used for AI generation */
+    model?: string;
+    /** Token count for AI generation */
+    tokens?: number;
+    /** Whether the result was cached */
+    cached?: boolean;
+    /** Whether this was a fallback from AI to placeholder */
+    fallback?: boolean;
+}
+/**
+ * Result of value generation
+ */
+export interface GenerationResult {
+    /** The generated value */
+    value: string;
+    /** Optional metadata about generation */
+    metadata?: GenerationMetadata;
+}
+/**
+ * Interface for value generation strategies
+ *
+ * Implementations provide different generation approaches:
+ * - PlaceholderValueGenerator: Deterministic values for testing
+ * - AIValueGenerator: AI-powered contextual generation
+ */
+export interface ValueGenerator {
+    /**
+     * Generate a value for a field
+     *
+     * @param request - The generation request with field info and context
+     * @returns Promise resolving to the generated value and metadata
+     */
+    generate(request: GenerationRequest): Promise<GenerationResult>;
+}
+/**
+ * AI function signature for value generation
+ */
+export type AIFunction = (prompt: string) => Promise<{
+    text: string;
+    usage?: {
+        tokens: number;
+    };
+}>;
+/**
+ * Configuration for creating a ValueGenerator
+ */
+export interface ValueGeneratorConfig {
+    /** Type of generator to create */
+    type?: 'placeholder' | 'ai';
+    /** AI function for AI generator (required when type is 'ai') */
+    aiFunction?: AIFunction;
+    /** Model to use for AI generation */
+    model?: string;
+    /** Maximum tokens for AI generation */
+    maxTokens?: number;
+    /** Temperature for AI generation */
+    temperature?: number;
+    /** Whether to fall back to placeholder on AI errors */
+    fallbackToPlaceholder?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/value-generators/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/schema/value-generators/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAMtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC9B,yCAAyC;IACzC,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,qBAAqB,CAAA;CAC1C;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAAA;IACrC,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;CAC9B;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAChE;AAMD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3B,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC3B,gEAAgE;IAChE,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC"}

package/dist/schema/value-generators/types.js

@@ -0,0 +1,11 @@
+/**
+ * ValueGenerator Type Definitions
+ *
+ * Defines the interface for value generation strategies used during
+ * entity creation. Supports both placeholder (deterministic test fixtures)
+ * and AI-powered (production) generation.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schema/value-generators/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/schema/value-generators/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/schema/version.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Schema Version Tracking
+ *
+ * Provides utilities for tracking schema versions, computing schema hashes,
+ * and storing/retrieving version metadata from the database.
+ *
+ * @packageDocumentation
+ */
+import type { DatabaseSchema } from '../types.js';
+import type { DBProvider } from './provider.js';
+/**
+ * Schema version metadata stored in the database
+ */
+export interface SchemaVersionInfo {
+    /** The version number (incremented on each migration) */
+    version: number;
+    /** Hash of the schema structure for change detection */
+    schemaHash: string;
+    /** When this version was applied */
+    appliedAt?: string;
+    /** Description of the migration (if any) */
+    description?: string;
+}
+/**
+ * Compute a deterministic hash of a database schema
+ *
+ * The hash is computed by:
+ * 1. Sorting entity names alphabetically
+ * 2. For each entity, sorting field names alphabetically
+ * 3. Creating a normalized JSON representation
+ * 4. Computing a hash of the JSON string
+ *
+ * This ensures the same schema always produces the same hash,
+ * regardless of property insertion order in the original object.
+ *
+ * @param schema - The database schema to hash
+ * @returns A hex string hash of the schema
+ *
+ * @example
+ * ```ts
+ * const hash = computeSchemaHash({
+ *   User: { name: 'string', email: 'string' },
+ *   Post: { title: 'string', author: 'User.posts' }
+ * })
+ * // => '8a7b3c9d...'
+ * ```
+ */
+export declare function computeSchemaHash(schema: DatabaseSchema): string;
+/**
+ * Get the current schema version from the database
+ *
+ * Reads the _schema_meta entity to retrieve the current schema version
+ * and hash. Returns null if no version has been set yet (first run).
+ *
+ * @param provider - The database provider
+ * @returns The current schema version info, or null if not set
+ *
+ * @example
+ * ```ts
+ * const version = await getSchemaVersion(provider)
+ * if (version) {
+ *   console.log(`Current version: ${version.version}`)
+ *   console.log(`Schema hash: ${version.schemaHash}`)
+ * } else {
+ *   console.log('No schema version set - first run')
+ * }
+ * ```
+ */
+export declare function getSchemaVersion(provider: DBProvider): Promise<SchemaVersionInfo | null>;
+/**
+ * Set the schema version in the database
+ *
+ * Stores the schema version and hash as a _schema_meta entity.
+ * Creates the entity if it doesn't exist, or updates it if it does.
+ *
+ * @param provider - The database provider
+ * @param version - The new version number
+ * @param schemaHash - The hash of the current schema
+ * @param description - Optional description of the migration
+ *
+ * @example
+ * ```ts
+ * await setSchemaVersion(provider, 1, 'abc123', 'Initial schema')
+ * await setSchemaVersion(provider, 2, 'def456', 'Added email field to User')
+ * ```
+ */
+export declare function setSchemaVersion(provider: DBProvider, version: number, schemaHash: string, description?: string): Promise<void>;
+/**
+ * Check if the schema has changed since the last recorded version
+ *
+ * Compares the current schema hash with the stored hash to detect changes.
+ *
+ * @param provider - The database provider
+ * @param schema - The current schema definition
+ * @returns Object with changed status and hashes
+ *
+ * @example
+ * ```ts
+ * const { changed, currentHash, storedHash } = await hasSchemaChanged(provider, schema)
+ * if (changed) {
+ *   console.log('Schema has changed, migration may be needed')
+ * }
+ * ```
+ */
+export declare function hasSchemaChanged(provider: DBProvider, schema: DatabaseSchema): Promise<{
+    changed: boolean;
+    currentHash: string;
+    storedHash: string | null;
+    storedVersion: number | null;
+}>;
+//# sourceMappingURL=version.d.ts.map