ai-database 2.1.1 → 2.3.0

package/dist/schema/diff.js

@@ -0,0 +1,329 @@
+/**
+ * Schema Diff Engine
+ *
+ * Provides utilities for comparing two parsed schemas and detecting
+ * added, removed, and modified entities and fields.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Field Comparison
+// =============================================================================
+/**
+ * Compare two fields and determine if they are different
+ *
+ * @param oldField - The old field definition
+ * @param newField - The new field definition
+ * @returns List of changes if different, empty array if same
+ */
+function compareFields(oldField, newField) {
+    const changes = [];
+    // Check type change
+    if (oldField.type !== newField.type) {
+        changes.push({
+            name: oldField.name,
+            oldField,
+            newField,
+            changeType: 'type',
+            description: `Type changed from '${oldField.type}' to '${newField.type}'`,
+        });
+    }
+    // Check optional change
+    if (oldField.isOptional !== newField.isOptional) {
+        changes.push({
+            name: oldField.name,
+            oldField,
+            newField,
+            changeType: 'optional',
+            description: oldField.isOptional
+                ? 'Field changed from optional to required'
+                : 'Field changed from required to optional',
+        });
+    }
+    // Check array change
+    if (oldField.isArray !== newField.isArray) {
+        changes.push({
+            name: oldField.name,
+            oldField,
+            newField,
+            changeType: 'array',
+            description: oldField.isArray
+                ? 'Field changed from array to single value'
+                : 'Field changed from single value to array',
+        });
+    }
+    // Check relation change
+    if (oldField.isRelation !== newField.isRelation) {
+        changes.push({
+            name: oldField.name,
+            oldField,
+            newField,
+            changeType: 'relation',
+            description: oldField.isRelation
+                ? 'Field changed from relation to primitive'
+                : 'Field changed from primitive to relation',
+        });
+    }
+    // Check operator change
+    if (oldField.operator !== newField.operator) {
+        changes.push({
+            name: oldField.name,
+            oldField,
+            newField,
+            changeType: 'operator',
+            description: `Operator changed from '${oldField.operator || 'none'}' to '${newField.operator || 'none'}'`,
+        });
+    }
+    return changes;
+}
+/**
+ * Detect possible field renames by matching types between removed and added fields
+ *
+ * @param removedFields - Fields that were removed
+ * @param addedFields - Fields that were added
+ * @returns Possible rename pairs with confidence scores
+ */
+function detectPossibleRenames(removedFields, addedFields) {
+    const possibleRenames = [];
+    for (const removed of removedFields) {
+        for (const added of addedFields) {
+            // Skip if names are the same (not a rename)
+            if (removed.name === added.name)
+                continue;
+            let confidence = 0;
+            const reasons = [];
+            // Same type = high confidence
+            if (removed.type === added.type) {
+                confidence += 0.5;
+                reasons.push('same type');
+            }
+            // Same isRelation flag
+            if (removed.isRelation === added.isRelation) {
+                confidence += 0.15;
+                reasons.push('same relation status');
+            }
+            // Same isArray flag
+            if (removed.isArray === added.isArray) {
+                confidence += 0.15;
+                reasons.push('same array status');
+            }
+            // Same isOptional flag
+            if (removed.isOptional === added.isOptional) {
+                confidence += 0.1;
+                reasons.push('same optional status');
+            }
+            // Same operator
+            if (removed.operator === added.operator) {
+                confidence += 0.1;
+                reasons.push('same operator');
+            }
+            // Only suggest if confidence is high enough
+            if (confidence >= 0.5) {
+                possibleRenames.push({
+                    oldName: removed.name,
+                    newName: added.name,
+                    confidence,
+                    reason: reasons.join(', '),
+                });
+            }
+        }
+    }
+    // Sort by confidence descending
+    possibleRenames.sort((a, b) => b.confidence - a.confidence);
+    return possibleRenames;
+}
+// =============================================================================
+// Entity Comparison
+// =============================================================================
+/**
+ * Compare two entities and detect differences
+ *
+ * @param entityName - Name of the entity being compared
+ * @param oldEntity - The old entity definition
+ * @param newEntity - The new entity definition
+ * @returns Entity diff with added, removed, and modified fields
+ */
+function compareEntities(entityName, oldEntity, newEntity) {
+    const addedFields = [];
+    const removedFields = [];
+    const changedFields = [];
+    // Get field names from both entities
+    const oldFieldNames = new Set(oldEntity.fields.keys());
+    const newFieldNames = new Set(newEntity.fields.keys());
+    // Find added fields
+    for (const fieldName of newFieldNames) {
+        if (!oldFieldNames.has(fieldName)) {
+            addedFields.push(newEntity.fields.get(fieldName));
+        }
+    }
+    // Find removed fields
+    for (const fieldName of oldFieldNames) {
+        if (!newFieldNames.has(fieldName)) {
+            removedFields.push(oldEntity.fields.get(fieldName));
+        }
+    }
+    // Find modified fields
+    for (const fieldName of oldFieldNames) {
+        if (newFieldNames.has(fieldName)) {
+            const oldField = oldEntity.fields.get(fieldName);
+            const newField = newEntity.fields.get(fieldName);
+            const fieldChanges = compareFields(oldField, newField);
+            if (fieldChanges.length > 0) {
+                // If multiple changes, consolidate into one entry
+                if (fieldChanges.length > 1) {
+                    changedFields.push({
+                        name: fieldName,
+                        oldField,
+                        newField,
+                        changeType: 'multiple',
+                        description: fieldChanges.map((c) => c.description).join('; '),
+                    });
+                }
+                else {
+                    changedFields.push(fieldChanges[0]);
+                }
+            }
+        }
+    }
+    // Detect possible renames
+    const possibleRenames = detectPossibleRenames(removedFields, addedFields);
+    return {
+        entityName,
+        addedFields,
+        removedFields,
+        changedFields,
+        possibleRenames,
+    };
+}
+// =============================================================================
+// Schema Comparison
+// =============================================================================
+/**
+ * Compare two parsed schemas and detect all differences
+ *
+ * This function performs a comprehensive comparison between two schemas,
+ * identifying:
+ * - Added entities (in new schema but not old)
+ * - Removed entities (in old schema but not new)
+ * - Modified entities (field changes within entities)
+ * - Possible field renames (based on type similarity)
+ *
+ * @param oldParsed - The old parsed schema
+ * @param newParsed - The new parsed schema
+ * @returns Complete diff with all detected changes
+ *
+ * @example
+ * ```ts
+ * const oldSchema = parseSchema({ User: { name: 'string' } })
+ * const newSchema = parseSchema({
+ *   User: { name: 'string', email: 'string' },
+ *   Post: { title: 'string' }
+ * })
+ *
+ * const diff = diffSchemas(oldSchema, newSchema)
+ * // diff.addedEntities = ['Post']
+ * // diff.modifiedEntities[0].addedFields[0].name = 'email'
+ * ```
+ */
+export function diffSchemas(oldParsed, newParsed) {
+    const addedEntities = [];
+    const removedEntities = [];
+    const modifiedEntities = [];
+    // Get entity names from both schemas
+    const oldEntityNames = new Set(oldParsed.entities.keys());
+    const newEntityNames = new Set(newParsed.entities.keys());
+    // Find added entities
+    for (const entityName of newEntityNames) {
+        if (!oldEntityNames.has(entityName)) {
+            addedEntities.push(entityName);
+        }
+    }
+    // Find removed entities
+    for (const entityName of oldEntityNames) {
+        if (!newEntityNames.has(entityName)) {
+            removedEntities.push(entityName);
+        }
+    }
+    // Find modified entities
+    for (const entityName of oldEntityNames) {
+        if (newEntityNames.has(entityName)) {
+            const oldEntity = oldParsed.entities.get(entityName);
+            const newEntity = newParsed.entities.get(entityName);
+            const entityDiff = compareEntities(entityName, oldEntity, newEntity);
+            // Only add to modified list if there are actual changes
+            if (entityDiff.addedFields.length > 0 ||
+                entityDiff.removedFields.length > 0 ||
+                entityDiff.changedFields.length > 0) {
+                modifiedEntities.push(entityDiff);
+            }
+        }
+    }
+    // Determine if there are any changes
+    const hasChanges = addedEntities.length > 0 || removedEntities.length > 0 || modifiedEntities.length > 0;
+    // Generate summary
+    const summaryParts = [];
+    if (addedEntities.length > 0) {
+        summaryParts.push(`${addedEntities.length} added entit${addedEntities.length === 1 ? 'y' : 'ies'}`);
+    }
+    if (removedEntities.length > 0) {
+        summaryParts.push(`${removedEntities.length} removed entit${removedEntities.length === 1 ? 'y' : 'ies'}`);
+    }
+    if (modifiedEntities.length > 0) {
+        summaryParts.push(`${modifiedEntities.length} modified entit${modifiedEntities.length === 1 ? 'y' : 'ies'}`);
+    }
+    const summary = hasChanges ? summaryParts.join(', ') : 'No changes detected';
+    return {
+        addedEntities,
+        removedEntities,
+        modifiedEntities,
+        hasChanges,
+        summary,
+    };
+}
+/**
+ * Get a human-readable description of a schema diff
+ *
+ * @param diff - The schema diff to describe
+ * @returns Multi-line string describing all changes
+ */
+export function describeDiff(diff) {
+    if (!diff.hasChanges) {
+        return 'No schema changes detected.';
+    }
+    const lines = ['Schema Changes:', ''];
+    if (diff.addedEntities.length > 0) {
+        lines.push('Added Entities:');
+        for (const entity of diff.addedEntities) {
+            lines.push(`  + ${entity}`);
+        }
+        lines.push('');
+    }
+    if (diff.removedEntities.length > 0) {
+        lines.push('Removed Entities:');
+        for (const entity of diff.removedEntities) {
+            lines.push(`  - ${entity}`);
+        }
+        lines.push('');
+    }
+    for (const entityDiff of diff.modifiedEntities) {
+        lines.push(`Modified: ${entityDiff.entityName}`);
+        for (const field of entityDiff.addedFields) {
+            lines.push(`  + ${field.name}: ${field.type}${field.isOptional ? '?' : ''}${field.isArray ? '[]' : ''}`);
+        }
+        for (const field of entityDiff.removedFields) {
+            lines.push(`  - ${field.name}: ${field.type}${field.isOptional ? '?' : ''}${field.isArray ? '[]' : ''}`);
+        }
+        for (const change of entityDiff.changedFields) {
+            lines.push(`  ~ ${change.name}: ${change.description}`);
+        }
+        if (entityDiff.possibleRenames.length > 0) {
+            lines.push('  Possible renames:');
+            for (const rename of entityDiff.possibleRenames) {
+                lines.push(`    ${rename.oldName} -> ${rename.newName} (${Math.round(rename.confidence * 100)}% confidence: ${rename.reason})`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=diff.js.map

package/dist/schema/diff.js.map

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

package/dist/schema/entity-operations.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Entity Operations Factory
+ *
+ * Contains the createEntityOperations<T>() function that creates typed CRUD operations
+ * for database entities. This includes get, list, find, create, update, upsert, delete,
+ * search, forEach, draft, and resolve operations.
+ *
+ * @packageDocumentation
+ */
+import type { ParsedEntity, ParsedSchema } from '../types.js';
+import type { DraftOptions, ResolveOptions, ListOptions, SearchOptions, SemanticSearchOptions, HybridSearchOptions, Draft, Resolved } from './types.js';
+import type { DBProvider } from './provider.js';
+/**
+ * Configuration for creating entity operations
+ */
+export interface EntityOperationsConfig {
+    /** The type name for the entity */
+    typeName: string;
+    /** The parsed entity definition */
+    entity: ParsedEntity;
+    /** The full parsed schema */
+    schema: ParsedSchema;
+}
+/**
+ * Operations available on each entity type
+ */
+export interface EntityOperations<T> {
+    get(id: string): Promise<T | null>;
+    list(options?: ListOptions): Promise<T[]>;
+    find(where: Partial<T>): Promise<T[]>;
+    search(query: string, options?: SearchOptions): Promise<T[]>;
+    create(data: Omit<T, '$id' | '$type'>): Promise<T>;
+    create(id: string, data: Omit<T, '$id' | '$type'>): Promise<T>;
+    update(id: string, data: Partial<Omit<T, '$id' | '$type'>>): Promise<T>;
+    upsert(id: string, data: Omit<T, '$id' | '$type'>): Promise<T>;
+    delete(id: string): Promise<boolean>;
+    forEach(callback: (entity: T) => void | Promise<void>): Promise<void>;
+    forEach(options: ListOptions, callback: (entity: T) => void | Promise<void>): Promise<void>;
+    semanticSearch?(query: string, options?: SemanticSearchOptions): Promise<Array<T & {
+        $score: number;
+    }>>;
+    hybridSearch?(query: string, options?: HybridSearchOptions): Promise<Array<T & {
+        $rrfScore: number;
+        $ftsRank: number;
+        $semanticRank: number;
+        $score: number;
+    }>>;
+    draft?(data: Partial<Omit<T, '$id' | '$type'>>, options?: DraftOptions): Promise<Draft<T>>;
+    resolve?(draft: Draft<T>, options?: ResolveOptions): Promise<Resolved<T>>;
+}
+/**
+ * Create typed CRUD operations for a database entity
+ *
+ * This function creates the full set of operations for working with a specific
+ * entity type in the database, including:
+ * - get/list/find for reading
+ * - create/update/upsert/delete for writing
+ * - search/semanticSearch/hybridSearch for querying
+ * - forEach for iteration
+ * - draft/resolve for two-phase entity creation
+ *
+ * @param typeName - The type name for the entity
+ * @param entity - The parsed entity definition
+ * @param schema - The full parsed schema
+ * @returns EntityOperations<T> with all available methods
+ */
+export declare function createEntityOperations<T>(typeName: string, entity: ParsedEntity, schema: ParsedSchema): EntityOperations<T>;
+/**
+ * Create specialized operations for the Edge entity type
+ *
+ * Edge entities are auto-generated from schema relationships and have
+ * restricted write operations (no manual create/update/delete).
+ *
+ * @param schemaEdgeRecords - Edge records derived from the schema
+ * @param getProvider - Function to get the database provider
+ * @returns EntityOperations for Edge type
+ */
+/**
+ * Create specialized operations for the Noun entity type
+ *
+ * Noun entities are auto-generated from schema entity types and have
+ * restricted write operations (no manual create/update/delete).
+ *
+ * @param nounRecords - Noun records derived from the schema entity types
+ * @returns EntityOperations for Noun type
+ */
+export declare function createNounEntityOperations(nounRecords: Array<Record<string, unknown>>): EntityOperations<Record<string, unknown>>;
+/**
+ * Create specialized operations for the Verb entity type
+ *
+ * Verb entities are the standard verb definitions (create, update, delete, etc.)
+ * and any custom verbs defined through the verbs API.
+ *
+ * @param verbRecords - Verb records with conjugation forms
+ * @returns EntityOperations for Verb type
+ */
+export declare function createVerbEntityOperations(verbRecords: Array<Record<string, unknown>>): EntityOperations<Record<string, unknown>>;
+export declare function createEdgeEntityOperations(schemaEdgeRecords: Array<Record<string, unknown>>, getProvider: () => Promise<DBProvider>): EntityOperations<Record<string, unknown>>;
+//# sourceMappingURL=entity-operations.d.ts.map

package/dist/schema/entity-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-operations.d.ts","sourceRoot":"","sources":["../../src/schema/entity-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE7D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EAEnB,KAAK,EACL,QAAQ,EAET,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAE,UAAU,EAA4C,MAAM,eAAe,CAAA;AA6EzF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,MAAM,EAAE,YAAY,CAAA;IACpB,6BAA6B;IAC7B,MAAM,EAAE,YAAY,CAAA;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAClC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IAC5D,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAClD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3F,cAAc,CAAC,CACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACzC,YAAY,CAAC,CACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CACR,KAAK,CAAC,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAC1F,CAAA;IACD,KAAK,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1F,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;CAC1E;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,gBAAgB,CAAC,CAAC,CAAC,CAipBrB;AAMD;;;;;;;;;GASG;AACH;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA2E3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA+E3C;AAED,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACjD,WAAW,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,GACrC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyH3C"}