ai-database 2.0.2 → 2.1.1

package/dist/schema/resolve.js

@@ -0,0 +1,474 @@
+/**
+ * Reference Resolution Functions
+ *
+ * Contains forward/backward resolution functions for relationships,
+ * context resolution, and entity hydration.
+ *
+ * @packageDocumentation
+ */
+import { hasSemanticSearch } from './provider.js';
+import { isPrimitiveType } from './parse.js';
+// =============================================================================
+// Context Resolution - Template Variables and $instructions
+// =============================================================================
+/**
+ * Check if a string looks like an entity ID (UUID format or type-prefixed)
+ */
+export function isEntityId(value) {
+    // UUID pattern
+    const uuidPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidPattern.test(value))
+        return true;
+    // Type-prefixed ID pattern (e.g., "post-123")
+    if (/^[a-z]+-[a-z0-9-]+$/i.test(value))
+        return true;
+    return false;
+}
+/**
+ * Infer the entity type from a field name using schema relationships
+ */
+export function inferTypeFromField(fieldName, entity, schema) {
+    // First check if field is a relation in the current entity
+    const field = entity.fields.get(fieldName);
+    if (field?.isRelation && field.relatedType) {
+        return field.relatedType;
+    }
+    // Check for camelCase field name that might match a type (e.g., "occupation" -> "Occupation")
+    const capitalizedName = fieldName.charAt(0).toUpperCase() + fieldName.slice(1);
+    if (schema.entities.has(capitalizedName)) {
+        return capitalizedName;
+    }
+    return undefined;
+}
+/**
+ * Resolve a context path like "task.occupation.industry.name" against an entity
+ *
+ * This traverses relationships and fetches related entities as needed.
+ */
+export async function resolveContextPath(path, entity, currentTypeName, schema, provider) {
+    const parts = path.split('.');
+    let current = entity;
+    let currentType = schema.entities.get(currentTypeName);
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        const record = current;
+        const value = record[part];
+        // If it's a string that looks like an entity ID, try to fetch the entity
+        if (typeof value === 'string' && isEntityId(value) && currentType) {
+            const typeName = inferTypeFromField(part, currentType, schema);
+            if (typeName) {
+                const fetched = await provider.get(typeName, value);
+                if (fetched) {
+                    current = fetched;
+                    currentType = schema.entities.get(typeName);
+                    continue;
+                }
+            }
+        }
+        current = value;
+        // Update currentType for next iteration if we have a valid field reference
+        if (currentType) {
+            const nextTypeName = inferTypeFromField(part, currentType, schema);
+            if (nextTypeName) {
+                currentType = schema.entities.get(nextTypeName);
+            }
+        }
+    }
+    return current;
+}
+/**
+ * Resolve template variables in $instructions
+ *
+ * Template variables use the syntax {path.to.field} where the path
+ * can traverse relationships (e.g., {task.occupation.title})
+ *
+ * @param instructions - The instruction string with template variables
+ * @param entity - The current entity data
+ * @param typeName - The current entity type name
+ * @param schema - The parsed schema
+ * @param provider - The database provider for fetching related entities
+ * @returns The instructions with all template variables resolved
+ */
+export async function resolveInstructions(instructions, entity, typeName, schema, provider) {
+    const pattern = /\{([^}]+)\}/g;
+    let resolved = instructions;
+    // Find all matches first to avoid issues with modifying string during iteration
+    const matches = [...instructions.matchAll(pattern)];
+    for (const match of matches) {
+        const path = match[1];
+        const value = await resolveContextPath(path, entity, typeName, schema, provider);
+        resolved = resolved.replace(match[0], String(value ?? ''));
+    }
+    return resolved;
+}
+/**
+ * Pre-fetch context dependencies declared in $context
+ *
+ * The $context field declares explicit context dependencies that should
+ * be pre-fetched before generating AI fields. This ensures all referenced
+ * entities are available for template variable resolution.
+ *
+ * @param contextDeps - Array of context dependency types (e.g., ['Startup', 'ICP'])
+ * @param entity - The current entity data
+ * @param typeName - The current entity type name
+ * @param schema - The parsed schema
+ * @param provider - The database provider for fetching related entities
+ * @returns Map of context name to fetched entity data
+ */
+export async function prefetchContext(contextDeps, entity, typeName, schema, provider) {
+    const contextData = new Map();
+    const currentEntity = schema.entities.get(typeName);
+    if (!currentEntity)
+        return contextData;
+    for (const dep of contextDeps) {
+        // Convert to camelCase for field lookup (e.g., "Startup" -> "startup")
+        const fieldName = dep.charAt(0).toLowerCase() + dep.slice(1);
+        // Check if we have a field that references this type
+        const field = currentEntity.fields.get(fieldName);
+        if (field?.isRelation && field.relatedType) {
+            const entityId = entity[fieldName];
+            if (typeof entityId === 'string') {
+                const fetched = await provider.get(field.relatedType, entityId);
+                if (fetched) {
+                    contextData.set(fieldName, fetched);
+                    // Also store nested relationships
+                    const relatedEntity = schema.entities.get(field.relatedType);
+                    if (relatedEntity) {
+                        for (const [nestedFieldName, nestedField] of relatedEntity.fields) {
+                            if (nestedField.isRelation && nestedField.relatedType) {
+                                const nestedId = fetched[nestedFieldName];
+                                if (typeof nestedId === 'string') {
+                                    const nestedFetched = await provider.get(nestedField.relatedType, nestedId);
+                                    if (nestedFetched) {
+                                        contextData.set(`${fieldName}.${nestedFieldName}`, nestedFetched);
+                                    }
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return contextData;
+}
+/**
+ * Check if a field type is a prompt (contains spaces, indicating AI generation)
+ */
+export function isPromptField(field) {
+    // Fields with spaces in their type are prompts for AI generation
+    return field.type.includes(' ') ||
+        (field.type === 'string' && !field.isRelation && !isPrimitiveType(field.type));
+}
+// =============================================================================
+// Nested Pending Resolution
+// =============================================================================
+/**
+ * Resolve pending nested relations in generated data
+ *
+ * When generateEntity encounters nested -> relations, it stores them as
+ * _pending_fieldName entries. This function creates those entities and
+ * replaces the pending entries with actual IDs.
+ */
+export async function resolveNestedPending(data, entity, schema, provider) {
+    const resolved = { ...data };
+    for (const key of Object.keys(resolved)) {
+        if (key.startsWith('_pending_')) {
+            const fieldName = key.replace('_pending_', '');
+            const pending = resolved[key];
+            delete resolved[key];
+            // Get the related entity to resolve its nested pending relations too
+            const relatedEntity = schema.entities.get(pending.type);
+            if (relatedEntity) {
+                const resolvedNested = await resolveNestedPending(pending.data, relatedEntity, schema, provider);
+                const created = await provider.create(pending.type, undefined, resolvedNested);
+                resolved[fieldName] = created.$id;
+            }
+        }
+    }
+    return resolved;
+}
+// =============================================================================
+// Reference Resolution
+// =============================================================================
+/**
+ * Resolve a single reference specification to an entity ID
+ *
+ * For exact matches (-> and <-), creates new entities.
+ * For fuzzy matches (~> and <~), searches for existing entities first.
+ */
+export async function resolveReferenceSpec(spec, contextData, schema, provider, generateContextAwareValue) {
+    const targetEntity = schema.entities.get(spec.type);
+    if (!targetEntity) {
+        throw new Error(`Unknown target type: ${spec.type}`);
+    }
+    if (spec.matchMode === 'fuzzy') {
+        // For fuzzy references, try to find an existing entity first
+        if (hasSemanticSearch(provider)) {
+            const searchQuery = spec.generatedText || spec.prompt || spec.field;
+            const matches = await provider.semanticSearch(spec.type, searchQuery, {
+                minScore: 0.5,
+                limit: 1,
+            });
+            const firstMatch = matches[0];
+            if (firstMatch) {
+                return firstMatch.$id;
+            }
+        }
+        // If no match found for fuzzy, fall through to create
+    }
+    // Create a new entity
+    const generatedData = {};
+    // Build context for generation
+    const hint = spec.generatedText || spec.prompt || spec.field;
+    const parentContextFields = [];
+    for (const [key, value] of Object.entries(contextData)) {
+        if (!key.startsWith('$') && !key.startsWith('_') && typeof value === 'string' && value) {
+            parentContextFields.push(`${key}: ${value}`);
+        }
+    }
+    const fullContext = [hint, ...parentContextFields].filter(Boolean).join(' | ');
+    // Generate default values for the target entity's fields
+    for (const [fieldName, field] of targetEntity.fields) {
+        if (!field.isRelation && !field.isOptional) {
+            if (field.type === 'string') {
+                generatedData[fieldName] = generateContextAwareValue(fieldName, spec.type, fullContext, hint, contextData);
+            }
+            else if (field.type === 'number') {
+                generatedData[fieldName] = 0;
+            }
+            else if (field.type === 'boolean') {
+                generatedData[fieldName] = false;
+            }
+        }
+        else if (field.isRelation && field.operator === '->' && !field.isArray && !field.isOptional) {
+            // Recursively resolve nested forward exact relations
+            const nestedSpec = {
+                field: fieldName,
+                operator: '->',
+                type: field.relatedType,
+                matchMode: 'exact',
+                resolved: false,
+                prompt: field.prompt,
+            };
+            const nestedId = await resolveReferenceSpec(nestedSpec, generatedData, schema, provider, generateContextAwareValue);
+            if (nestedId) {
+                generatedData[fieldName] = nestedId;
+            }
+        }
+    }
+    // Use parent ID if available, otherwise use a descriptive string
+    const parentId = contextData.$id;
+    const created = await provider.create(spec.type, undefined, {
+        ...generatedData,
+        $generated: true,
+        $generatedBy: parentId || (spec.matchMode === 'fuzzy' ? 'fuzzy-resolution' : 'reference-resolution'),
+        $sourceField: spec.field,
+    });
+    return created.$id;
+}
+// =============================================================================
+// Entity Hydration
+// =============================================================================
+/**
+ * Hydrate an entity with lazy-loaded relations
+ *
+ * For backward edges (direction === 'backward'), we query for entities
+ * of the related type that have a reference pointing TO this entity.
+ * This enables reverse lookups like "get all comments for a post".
+ *
+ * Backward reference resolution:
+ * - Single backward ref with stored ID: resolve directly (e.g., member.team = teamId -> get Team by ID)
+ * - Single backward ref without stored ID: find related entity that points to us via relations
+ * - Array backward ref: find all entities of related type where their forward ref points to us
+ */
+export function hydrateEntity(data, entity, schema, resolveProvider) {
+    const hydrated = { ...data };
+    const id = (data.$id || data.id);
+    const typeName = entity.name;
+    // Add lazy getters for relations
+    for (const [fieldName, field] of entity.fields) {
+        if (field.isRelation && field.relatedType) {
+            const relatedEntity = schema.entities.get(field.relatedType);
+            if (!relatedEntity)
+                continue;
+            // Check if this is a backward edge
+            const isBackward = field.direction === 'backward';
+            // For forward single relations with stored IDs, create a proxy that:
+            // - Acts like a string (for .toMatch(), String(), etc.)
+            // - Can be awaited to get the related entity (thenable)
+            if (!isBackward && !field.isArray && data[fieldName]) {
+                const storedId = data[fieldName];
+                const thenableProxy = new Proxy({}, {
+                    get(target, prop) {
+                        if (prop === 'then') {
+                            return (resolve, reject) => {
+                                return (async () => {
+                                    const provider = await resolveProvider();
+                                    const result = await provider.get(field.relatedType, storedId);
+                                    return result ? hydrateEntity(result, relatedEntity, schema, resolveProvider) : null;
+                                })().then(resolve, reject);
+                            };
+                        }
+                        if (prop === Symbol.toPrimitive || prop === 'valueOf') {
+                            return () => storedId;
+                        }
+                        if (prop === 'toString') {
+                            return () => storedId;
+                        }
+                        if (prop === 'match') {
+                            return (regex) => storedId.match(regex);
+                        }
+                        if (prop === '$type') {
+                            return field.relatedType;
+                        }
+                        return undefined;
+                    },
+                });
+                hydrated[fieldName] = thenableProxy;
+                continue;
+            }
+            // For forward array relations with stored IDs, create a thenable array that:
+            // - Behaves like a normal array of IDs (has length, can be iterated, etc.)
+            // - Can be awaited to fetch and hydrate the full entities
+            // Note: we create the proxy even for empty arrays so they have $type for batch loading detection
+            if (!isBackward && field.isArray && Array.isArray(data[fieldName])) {
+                const storedIds = data[fieldName];
+                // Create a proxy that wraps the array but adds thenable behavior
+                const thenableArray = new Proxy(storedIds, {
+                    get(target, prop) {
+                        if (prop === 'then') {
+                            return (resolve, reject) => {
+                                return (async () => {
+                                    const provider = await resolveProvider();
+                                    const results = await Promise.all(storedIds.map(targetId => provider.get(field.relatedType, targetId)));
+                                    return results.filter(r => r !== null).map((r) => hydrateEntity(r, relatedEntity, schema, resolveProvider));
+                                })().then(resolve, reject);
+                            };
+                        }
+                        // Expose $type for batch loading detection
+                        if (prop === '$type') {
+                            return field.relatedType;
+                        }
+                        // Expose $isArrayRelation marker for batch loading
+                        if (prop === '$isArrayRelation') {
+                            return true;
+                        }
+                        // For all other properties, delegate to the actual array
+                        const value = Reflect.get(target, prop);
+                        // Bind methods to the target array
+                        if (typeof value === 'function') {
+                            return value.bind(target);
+                        }
+                        return value;
+                    },
+                });
+                hydrated[fieldName] = thenableArray;
+                continue;
+            }
+            // Define lazy getter
+            Object.defineProperty(hydrated, fieldName, {
+                get: () => {
+                    // Check if this is a backward edge
+                    if (isBackward && !field.isArray) {
+                        // Case 1: Single backward ref
+                        // Returns a Promise that resolves to the related entity
+                        const storedId = data[fieldName];
+                        return (async () => {
+                            const provider = await resolveProvider();
+                            if (storedId) {
+                                // Has stored ID - directly fetch the related entity
+                                const result = await provider.get(field.relatedType, storedId);
+                                return result
+                                    ? hydrateEntity(result, relatedEntity, schema, resolveProvider)
+                                    : null;
+                            }
+                            // No stored ID - find via inverse relation lookup
+                            // Find entities of relatedType that have this entity in their relations
+                            for (const [relFieldName, relField] of relatedEntity.fields) {
+                                if (relField.isRelation &&
+                                    relField.relatedType === typeName &&
+                                    relField.direction !== 'backward' &&
+                                    relField.isArray) {
+                                    // Found a forward array relation on related entity pointing to us
+                                    // Check if any entity of relatedType has this entity in that relation
+                                    const allRelated = await provider.list(field.relatedType);
+                                    for (const candidate of allRelated) {
+                                        const candidateId = (candidate.$id || candidate.id);
+                                        const related = await provider.related(field.relatedType, candidateId, relFieldName);
+                                        if (related.some(r => (r.$id || r.id) === id)) {
+                                            return hydrateEntity(candidate, relatedEntity, schema, resolveProvider);
+                                        }
+                                    }
+                                }
+                            }
+                            return null;
+                        })();
+                    }
+                    // For forward relations and backward arrays, return async resolver
+                    return (async () => {
+                        const provider = await resolveProvider();
+                        if (isBackward) {
+                            // Case 2: Array backward ref
+                            // Check if we have stored IDs (e.g., from backward fuzzy resolution)
+                            const storedIds = data[fieldName];
+                            if (Array.isArray(storedIds) && storedIds.length > 0) {
+                                // Use stored IDs directly - this handles backward fuzzy (<~) array fields
+                                const results = await Promise.all(storedIds.map(targetId => provider.get(field.relatedType, targetId)));
+                                return Promise.all(results.filter(r => r !== null).map((r) => hydrateEntity(r, relatedEntity, schema, resolveProvider)));
+                            }
+                            // No stored IDs - use backref lookup
+                            // e.g., Blog.posts: ['<-Post'] - find Posts where post.blog === blog.$id
+                            // The backref tells us which field on the related type stores our ID
+                            // If no explicit backref, infer from schema relationships
+                            let backrefField = field.backref;
+                            if (!backrefField) {
+                                // Infer backref: look for a field on related entity that points to us
+                                for (const [relFieldName, relField] of relatedEntity.fields) {
+                                    if (relField.isRelation &&
+                                        relField.relatedType === typeName &&
+                                        relField.direction !== 'backward' &&
+                                        !relField.isArray) {
+                                        // Found a forward single relation pointing to us - use its name
+                                        backrefField = relFieldName;
+                                        break;
+                                    }
+                                }
+                                // Fallback to entity name lowercase if no explicit relation found
+                                if (!backrefField) {
+                                    backrefField = typeName.toLowerCase();
+                                }
+                            }
+                            // Query the related type for entities that reference this entity
+                            const results = await provider.list(field.relatedType, {
+                                where: { [backrefField]: id },
+                            });
+                            return Promise.all(results.map((r) => hydrateEntity(r, relatedEntity, schema, resolveProvider)));
+                        }
+                        else if (field.isArray) {
+                            // Forward array relation - get related entities via relationship
+                            const results = await provider.related(entity.name, id, fieldName);
+                            return Promise.all(results.map((r) => hydrateEntity(r, relatedEntity, schema, resolveProvider)));
+                        }
+                        else {
+                            // Forward single relation - get the stored ID and fetch
+                            const relatedId = data[fieldName];
+                            if (!relatedId)
+                                return null;
+                            const result = await provider.get(field.relatedType, relatedId);
+                            return result
+                                ? hydrateEntity(result, relatedEntity, schema, resolveProvider)
+                                : null;
+                        }
+                    })();
+                },
+                enumerable: true,
+                configurable: true,
+            });
+        }
+    }
+    return hydrated;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/schema/resolve.js.map

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

package/dist/schema/semantic.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Semantic Search and Matching
+ *
+ * Contains backward fuzzy (<~) and forward fuzzy (~>) resolution functions
+ * for semantic search-based relationship matching.
+ *
+ * @packageDocumentation
+ */
+import type { ParsedEntity, ParsedSchema } from '../types.js';
+import type { DBProvider } from './provider.js';
+/**
+ * Resolve backward fuzzy (<~) fields by using semantic search to find existing entities
+ *
+ * The <~ operator differs from <- in that it uses semantic/fuzzy matching:
+ * - Uses AI/embedding-based similarity to find the best match from existing entities
+ * - Does NOT generate new entities - only grounds to existing reference data
+ * - Uses hint fields (e.g., categoryHint for category field) to guide matching
+ *
+ * @param typeName - The type of entity being created
+ * @param data - The input data including hint fields
+ * @param entity - The parsed entity definition
+ * @param schema - The parsed schema
+ * @param provider - The database provider (must support semanticSearch)
+ * @returns The resolved data with backward fuzzy fields populated with matched entity IDs
+ */
+export declare function resolveBackwardFuzzy(typeName: string, data: Record<string, unknown>, entity: ParsedEntity, schema: ParsedSchema, provider: DBProvider): Promise<Record<string, unknown>>;
+/**
+ * Resolve forward fuzzy (~>) fields via semantic search then generation
+ *
+ * The ~> operator differs from -> in that it first attempts semantic search:
+ * - Searches existing entities via embedding similarity
+ * - If a match is found above threshold, reuses the existing entity
+ * - If no match is found, generates a new entity
+ * - Respects configurable similarity threshold ($fuzzyThreshold or field-level)
+ *
+ * @param typeName - The type of entity being created
+ * @param data - The input data including hint fields
+ * @param entity - The parsed entity definition
+ * @param schema - The parsed schema
+ * @param provider - The database provider (must support semanticSearch)
+ * @param parentId - Pre-generated ID of the parent entity for backward refs
+ * @returns Object with resolved data and pending relations for array fields
+ */
+export declare function resolveForwardFuzzy(typeName: string, data: Record<string, unknown>, entity: ParsedEntity, schema: ParsedSchema, provider: DBProvider, parentId: string): Promise<{
+    data: Record<string, unknown>;
+    pendingRelations: Array<{
+        fieldName: string;
+        targetType: string;
+        targetId: string;
+        similarity?: number;
+    }>;
+}>;
+//# sourceMappingURL=semantic.d.ts.map

package/dist/schema/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/schema/semantic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EAEb,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,eAAe,CAAA;AA+BrE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiDlC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,gBAAgB,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAoKvJ"}