@dooor-ai/cortexdb 0.6.1 → 0.6.2

package/dist/schema-decorators/validator.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Schema Validator for CortexDB TypeScript Schemas
+ *
+ * Validates relationships and schema consistency, similar to Prisma's validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSchema = validateSchema;
+exports.formatValidationErrors = formatValidationErrors;
+const types_1 = require("../types");
+/**
+ * Validate all loaded collections for consistency
+ */
+function validateSchema(collections) {
+    const errors = [];
+    const warnings = [];
+    // Build a map of collection names for quick lookup
+    const collectionMap = new Map();
+    const classNameToCollection = new Map();
+    for (const col of collections) {
+        collectionMap.set(col.name, col);
+        // Also map by class name if available
+        if (col.className) {
+            classNameToCollection.set(col.className, col.name);
+        }
+    }
+    for (const collection of collections) {
+        // Validate each field
+        for (const field of collection.fields) {
+            // Check for relationship fields (they end with _id or _ids)
+            if (field.name.endsWith('_id')) {
+                const relationName = field.name.slice(0, -3); // Remove _id
+                // Check if there's a corresponding target (we need metadata for this)
+                // For now, warn if it looks like a foreign key but target is unknown
+                if (field.description?.includes('Foreign key to')) {
+                    const targetMatch = field.description.match(/Foreign key to (\w+)/);
+                    if (targetMatch) {
+                        const targetClassName = targetMatch[1];
+                        const targetCollection = classNameToCollection.get(targetClassName);
+                        if (!targetCollection && !collectionMap.has(targetClassName.toLowerCase())) {
+                            errors.push({
+                                collection: collection.name,
+                                field: field.name,
+                                message: `Relationship target "${targetClassName}" not found`,
+                                suggestion: `Create a collection with @Collection decorator for "${targetClassName}" or check if the class is exported from your schema file`,
+                            });
+                        }
+                    }
+                }
+            }
+            // Check for Many-to-Many fields
+            if (field.name.endsWith('_ids') && field.type === 'json') {
+                const relationName = field.name.slice(0, -4); // Remove _ids
+                if (field.description?.includes('Many-to-many relationship with')) {
+                    const targetMatch = field.description.match(/Many-to-many relationship with (\w+)/);
+                    if (targetMatch) {
+                        const targetName = targetMatch[1];
+                        // ManyToMany should have a corresponding relationship on the other side
+                        // This is a warning, not an error, since it can be unidirectional
+                        const targetCollection = collectionMap.get(targetName.toLowerCase());
+                        if (!targetCollection) {
+                            warnings.push({
+                                collection: collection.name,
+                                field: field.name,
+                                message: `Many-to-many target "${targetName}" not found in schema`,
+                                suggestion: `If "${targetName}" is a valid collection, make sure it's defined in your schema files`,
+                            });
+                        }
+                    }
+                }
+            }
+            // Validate enum fields have values
+            if (field.type === 'enum' && (!field.values || field.values.length === 0)) {
+                errors.push({
+                    collection: collection.name,
+                    field: field.name,
+                    message: `Enum field "${field.name}" has no values defined`,
+                    suggestion: `Add values array: @Field({ type: FieldType.ENUM, values: ["value1", "value2"] })`,
+                });
+            }
+            // Validate vectorize fields have appropriate store_in
+            if (field.vectorize) {
+                const storeIn = (field.store_in || []);
+                const hasQdrant = storeIn.some(s => s === types_1.StoreLocation.QDRANT || s === types_1.StoreLocation.QDRANT_PAYLOAD);
+                if (!hasQdrant) {
+                    warnings.push({
+                        collection: collection.name,
+                        field: field.name,
+                        message: `Field "${field.name}" has vectorize=true but is not stored in Qdrant`,
+                        suggestion: `Add StoreLocation.QDRANT to storeIn for vector search to work`,
+                    });
+                }
+            }
+            // Validate file fields
+            if (field.type === 'file') {
+                const storeIn = (field.store_in || []);
+                const hasMinio = storeIn.some(s => s === types_1.StoreLocation.MINIO);
+                if (!hasMinio) {
+                    warnings.push({
+                        collection: collection.name,
+                        field: field.name,
+                        message: `File field "${field.name}" is not stored in MinIO`,
+                        suggestion: `Add StoreLocation.MINIO to storeIn for file storage`,
+                    });
+                }
+            }
+            // Check for duplicate field names
+            const fieldNames = collection.fields.map(f => f.name);
+            const duplicates = fieldNames.filter((name, index) => fieldNames.indexOf(name) !== index);
+            if (duplicates.length > 0) {
+                errors.push({
+                    collection: collection.name,
+                    message: `Duplicate field names: ${[...new Set(duplicates)].join(', ')}`,
+                    suggestion: `Remove duplicate @Field decorators or rename the fields`,
+                });
+            }
+        }
+        // Validate collection has at least one field
+        if (collection.fields.length === 0) {
+            warnings.push({
+                collection: collection.name,
+                message: `Collection "${collection.name}" has no fields defined`,
+                suggestion: `Add at least one @Field decorator to your collection class`,
+            });
+        }
+        // Validate collection name is lowercase and valid
+        if (collection.name !== collection.name.toLowerCase()) {
+            warnings.push({
+                collection: collection.name,
+                message: `Collection name "${collection.name}" contains uppercase letters`,
+                suggestion: `Use lowercase names for consistency (e.g., "${collection.name.toLowerCase()}")`,
+            });
+        }
+        if (!/^[a-z][a-z0-9_]*$/.test(collection.name)) {
+            errors.push({
+                collection: collection.name,
+                message: `Invalid collection name "${collection.name}"`,
+                suggestion: `Collection names must start with a letter and contain only lowercase letters, numbers, and underscores`,
+            });
+        }
+    }
+    // Check for duplicate collection names
+    const collectionNames = collections.map(c => c.name);
+    const duplicateCollections = collectionNames.filter((name, index) => collectionNames.indexOf(name) !== index);
+    if (duplicateCollections.length > 0) {
+        errors.push({
+            collection: duplicateCollections[0],
+            message: `Duplicate collection names: ${[...new Set(duplicateCollections)].join(', ')}`,
+            suggestion: `Each collection must have a unique name`,
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Format validation errors for display
+ */
+function formatValidationErrors(result) {
+    const lines = [];
+    if (result.errors.length > 0) {
+        lines.push('\n❌ Schema validation errors:\n');
+        for (const error of result.errors) {
+            const location = error.field
+                ? `${error.collection}.${error.field}`
+                : error.collection;
+            lines.push(`  Error in ${location}:`);
+            lines.push(`    ${error.message}`);
+            if (error.suggestion) {
+                lines.push(`    💡 ${error.suggestion}`);
+            }
+            lines.push('');
+        }
+    }
+    if (result.warnings.length > 0) {
+        lines.push('\n⚠️  Schema warnings:\n');
+        for (const warning of result.warnings) {
+            const location = warning.field
+                ? `${warning.collection}.${warning.field}`
+                : warning.collection;
+            lines.push(`  Warning in ${location}:`);
+            lines.push(`    ${warning.message}`);
+            if (warning.suggestion) {
+                lines.push(`    💡 ${warning.suggestion}`);
+            }
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=validator.js.map

package/dist/schema-decorators/validator.js.map

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

package/package.json

@@ -1,9 +1,26 @@
 {
   "name": "@dooor-ai/cortexdb",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Official TypeScript/JavaScript SDK for CortexDB - Multi-modal RAG Platform with advanced document processing",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./schema-decorators": {
+      "import": "./dist/schema-decorators/index.js",
+      "require": "./dist/schema-decorators/index.js",
+      "types": "./dist/schema-decorators/index.d.ts"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "schema-decorators": ["dist/schema-decorators/index.d.ts"]
+    }
+  },
   "bin": {
     "cortexdb-schema": "dist/schema-cli/index.js"
   },