ai-database 2.1.1 → 2.3.0

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":"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"}

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/verb-derivation.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Verb Derivation for Backward Cascade Resolution
+ *
+ * Derives reverse verbs for backward relationships:
+ * - manages -> managedBy
+ * - owns -> ownedBy
+ * - creates -> createdBy
+ * - parent_of <-> child_of (bidirectional)
+ *
+ * Used by the cascade resolver to determine the reverse relationship
+ * when traversing relationships in the opposite direction.
+ *
+ * @example
+ * ```ts
+ * import { deriveReverseVerb, fieldNameToVerb, isPassiveVerb } from './verb-derivation.js'
+ *
+ * deriveReverseVerb('manages')     // 'managedBy'
+ * deriveReverseVerb('parent_of')   // 'child_of'
+ * deriveReverseVerb('managedBy')   // 'manages'
+ *
+ * fieldNameToVerb('manager')       // 'manages'
+ * fieldNameToVerb('owner')         // 'owns'
+ *
+ * isPassiveVerb('managedBy')       // true
+ * isPassiveVerb('manages')         // false
+ * ```
+ *
+ * @packageDocumentation
+ */
+/**
+ * Forward verbs to their reverse forms.
+ * Common active verbs mapped to their passive counterparts.
+ *
+ * @example
+ * ```ts
+ * FORWARD_TO_REVERSE.manages   // 'managedBy'
+ * FORWARD_TO_REVERSE.owns      // 'ownedBy'
+ * FORWARD_TO_REVERSE.creates   // 'createdBy'
+ * ```
+ */
+export declare const FORWARD_TO_REVERSE: Readonly<Record<string, string>>;
+/**
+ * Known verb pairs for bidirectional relationships.
+ * These are symmetric - each maps to the other.
+ *
+ * @example
+ * ```ts
+ * BIDIRECTIONAL_PAIRS.parent_of  // 'child_of'
+ * BIDIRECTIONAL_PAIRS.child_of   // 'parent_of'
+ * ```
+ */
+export declare const BIDIRECTIONAL_PAIRS: Readonly<Record<string, string>>;
+/**
+ * Derives the reverse verb for a given forward verb.
+ *
+ * Resolution order:
+ * 1. Check bidirectional pairs first (parent_of <-> child_of)
+ * 2. Check known forward verbs (manages -> managedBy)
+ * 3. Check if already a reversed verb (managedBy -> manages)
+ * 4. Apply standard transformation for verbs ending in 's'
+ * 5. Add 'By' suffix for unknown verbs
+ *
+ * @param verb - The verb to derive the reverse of
+ * @returns The reverse verb
+ *
+ * @example
+ * ```ts
+ * deriveReverseVerb('manages')        // 'managedBy'
+ * deriveReverseVerb('owns')           // 'ownedBy'
+ * deriveReverseVerb('parent_of')      // 'child_of'
+ * deriveReverseVerb('managedBy')      // 'manages' (already reversed)
+ * deriveReverseVerb('customAction')   // 'customActionBy' (unknown verb)
+ * ```
+ */
+export declare function deriveReverseVerb(verb: string): string;
+/**
+ * Derives a verb from a field name.
+ *
+ * Common field names like "manager", "owner", "creator" are mapped
+ * to their corresponding verbs. Unknown field names are returned as-is.
+ *
+ * @param fieldName - The field name to derive a verb from
+ * @returns The derived verb or the field name if no mapping exists
+ *
+ * @example
+ * ```ts
+ * fieldNameToVerb('manager')     // 'manages'
+ * fieldNameToVerb('owner')       // 'owns'
+ * fieldNameToVerb('creator')     // 'creates'
+ * fieldNameToVerb('customField') // 'customField' (no mapping)
+ * ```
+ */
+export declare function fieldNameToVerb(fieldName: string): string;
+/**
+ * Checks if a verb is in passive form.
+ *
+ * A verb is considered passive if it ends with:
+ * - 'By' (managedBy, ownedBy, createdBy)
+ * - 'To' (relatedTo, linkedTo, connectedTo)
+ * - 'Of' (parent_of, child_of, partOf)
+ *
+ * @param verb - The verb to check
+ * @returns True if the verb is passive, false otherwise
+ *
+ * @example
+ * ```ts
+ * isPassiveVerb('managedBy')   // true
+ * isPassiveVerb('relatedTo')   // true
+ * isPassiveVerb('parent_of')   // true
+ * isPassiveVerb('manages')     // false
+ * ```
+ */
+export declare function isPassiveVerb(verb: string): boolean;
+/**
+ * Register a custom verb pair for forward/reverse derivation.
+ *
+ * This allows extending the verb derivation system with domain-specific
+ * verb mappings at runtime.
+ *
+ * @param forward - The forward (active) verb
+ * @param reverse - The reverse (passive) verb
+ *
+ * @example
+ * ```ts
+ * registerVerbPair('sponsors', 'sponsoredBy')
+ * deriveReverseVerb('sponsors')     // 'sponsoredBy'
+ * deriveReverseVerb('sponsoredBy')  // 'sponsors'
+ * ```
+ */
+export declare function registerVerbPair(forward: string, reverse: string): void;
+/**
+ * Register a bidirectional verb pair.
+ *
+ * Bidirectional pairs are symmetric relationships where each verb
+ * maps to the other. For self-referential relationships, both
+ * arguments can be the same verb.
+ *
+ * @param verbA - The first verb
+ * @param verbB - The second verb (can be same as verbA for symmetric)
+ *
+ * @example
+ * ```ts
+ * // Asymmetric bidirectional
+ * registerBidirectionalPair('mentor_of', 'mentee_of')
+ * deriveReverseVerb('mentor_of')  // 'mentee_of'
+ * deriveReverseVerb('mentee_of')  // 'mentor_of'
+ *
+ * // Symmetric (self-referential)
+ * registerBidirectionalPair('relatedTo', 'relatedTo')
+ * deriveReverseVerb('relatedTo')  // 'relatedTo'
+ * ```
+ */
+export declare function registerBidirectionalPair(verbA: string, verbB: string): void;
+/**
+ * Register a field name to verb mapping.
+ *
+ * @param fieldName - The field name
+ * @param verb - The verb it derives to
+ *
+ * @example
+ * ```ts
+ * registerFieldVerb('coordinator', 'coordinates')
+ * fieldNameToVerb('coordinator')  // 'coordinates'
+ * ```
+ */
+export declare function registerFieldVerb(fieldName: string, verb: string): void;
+//# sourceMappingURL=verb-derivation.d.ts.map

package/dist/schema/verb-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verb-derivation.d.ts","sourceRoot":"","sources":["../../src/schema/verb-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAiCH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAqB,CAAA;AAcrF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAuB,CAAA;AAwBxF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwCtD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYnD;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGvE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvE"}