@dooor-ai/cortexdb 0.6.1 → 0.6.2

package/dist/schema-decorators/decorators.js

@@ -0,0 +1,277 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Collection = Collection;
+exports.Field = Field;
+exports.getCollectionMetadata = getCollectionMetadata;
+exports.getFieldMetadata = getFieldMetadata;
+exports.clearMetadata = clearMetadata;
+exports.getRelationshipMetadata = getRelationshipMetadata;
+exports.getAllRelationshipMetadata = getAllRelationshipMetadata;
+exports.fieldMetadataToDefinition = fieldMetadataToDefinition;
+exports.ManyToOne = ManyToOne;
+exports.OneToOne = OneToOne;
+exports.OneToMany = OneToMany;
+exports.ManyToMany = ManyToMany;
+const types_1 = require("../types");
+const collectionMetadata = new Map();
+const fieldMetadata = new Map();
+const relationshipMetadata = new Map();
+function Collection(options) {
+    return function (target) {
+        const className = target.name;
+        collectionMetadata.set(className, {
+            name: options.name,
+            description: options.description,
+            database: options.database,
+            config: options.config,
+        });
+    };
+}
+function Field(options) {
+    return function (target, propertyKey) {
+        const key = String(propertyKey);
+        const prototype = target;
+        const constructor = Object.getPrototypeOf(prototype).constructor;
+        if (!constructor || constructor === Object) {
+            const targetConstructor = prototype.constructor;
+            if (!targetConstructor) {
+                throw new Error(`Cannot determine constructor for field ${key}`);
+            }
+            if (!fieldMetadata.has(targetConstructor)) {
+                fieldMetadata.set(targetConstructor, []);
+            }
+            const fields = fieldMetadata.get(targetConstructor);
+            fields.push({
+                name: key,
+                type: options.type,
+                description: options.description,
+                required: options.required ?? false,
+                indexed: options.indexed ?? false,
+                unique: options.unique ?? false,
+                filterable: options.filterable ?? false,
+                vectorize: options.vectorize ?? false,
+                default: options.default,
+                values: options.values,
+                storeIn: options.storeIn,
+                extractConfig: options.extractConfig,
+                schema: options.schema,
+            });
+            return;
+        }
+        if (!fieldMetadata.has(constructor)) {
+            fieldMetadata.set(constructor, []);
+        }
+        const fields = fieldMetadata.get(constructor);
+        fields.push({
+            name: key,
+            type: options.type,
+            description: options.description,
+            required: options.required ?? false,
+            indexed: options.indexed ?? false,
+            unique: options.unique ?? false,
+            filterable: options.filterable ?? false,
+            vectorize: options.vectorize ?? false,
+            default: options.default,
+            values: options.values,
+            storeIn: options.storeIn,
+            extractConfig: options.extractConfig,
+            schema: options.schema,
+        });
+    };
+}
+function getCollectionMetadata() {
+    return collectionMetadata;
+}
+function getFieldMetadata(target) {
+    return fieldMetadata.get(target);
+}
+function clearMetadata() {
+    collectionMetadata.clear();
+    fieldMetadata.clear();
+    relationshipMetadata.clear();
+}
+function getRelationshipMetadata(target) {
+    return relationshipMetadata.get(target);
+}
+function getAllRelationshipMetadata() {
+    return relationshipMetadata;
+}
+function fieldMetadataToDefinition(field) {
+    return {
+        name: field.name,
+        type: field.type,
+        description: field.description,
+        required: field.required,
+        indexed: field.indexed,
+        unique: field.unique,
+        filterable: field.filterable,
+        vectorize: field.vectorize,
+        default: field.default,
+        values: field.values,
+        store_in: field.storeIn,
+        extract_config: field.extractConfig,
+        schema: field.schema,
+    };
+}
+/**
+ * Many-to-One relationship (N:1)
+ *
+ * @example
+ * ```typescript
+ * @Collection({ name: "posts" })
+ * class Post {
+ *   @ManyToOne({
+ *     target: () => User,
+ *     required: true,
+ *     indexed: true
+ *   })
+ *   author!: User;  // Creates author_id foreign key
+ * }
+ * ```
+ */
+function ManyToOne(options) {
+    return function (target, propertyKey) {
+        const key = String(propertyKey);
+        const foreignKey = options.foreignKey || `${key}_id`;
+        const prototype = target;
+        const constructor = Object.getPrototypeOf(prototype).constructor;
+        if (!fieldMetadata.has(constructor)) {
+            fieldMetadata.set(constructor, []);
+        }
+        const fields = fieldMetadata.get(constructor);
+        // Add foreign key field
+        fields.push({
+            name: foreignKey,
+            type: types_1.FieldType.STRING,
+            description: options.description || `Foreign key to ${key}`,
+            required: options.required ?? false,
+            indexed: options.indexed ?? true, // Index by default for performance
+            unique: false,
+            filterable: options.filterable ?? true, // Enable filtering by default
+            vectorize: false,
+            storeIn: [types_1.StoreLocation.POSTGRES, types_1.StoreLocation.QDRANT_PAYLOAD],
+        });
+        // Store relationship metadata for validation
+        if (!relationshipMetadata.has(constructor)) {
+            relationshipMetadata.set(constructor, []);
+        }
+        const relationships = relationshipMetadata.get(constructor);
+        const targetClass = options.target();
+        relationships.push({
+            fieldName: key,
+            type: 'ManyToOne',
+            targetClassName: targetClass.name,
+            foreignKey,
+            required: options.required,
+        });
+    };
+}
+/**
+ * One-to-One relationship (1:1)
+ *
+ * @example
+ * ```typescript
+ * @Collection({ name: "users" })
+ * class User {
+ *   @OneToOne({
+ *     target: () => Profile,
+ *     owner: true,
+ *     required: false
+ *   })
+ *   profile?: Profile;  // Creates profile_id foreign key
+ * }
+ * ```
+ */
+function OneToOne(options) {
+    return function (target, propertyKey) {
+        // Only create foreign key on the owning side
+        if (options.owner === false) {
+            return; // Non-owning side, no field needed
+        }
+        const key = String(propertyKey);
+        const foreignKey = options.foreignKey || `${key}_id`;
+        const prototype = target;
+        const constructor = Object.getPrototypeOf(prototype).constructor;
+        if (!fieldMetadata.has(constructor)) {
+            fieldMetadata.set(constructor, []);
+        }
+        const fields = fieldMetadata.get(constructor);
+        // Add foreign key field with unique constraint
+        fields.push({
+            name: foreignKey,
+            type: types_1.FieldType.STRING,
+            description: options.description || `Foreign key to ${key} (1:1)`,
+            required: options.required ?? false,
+            indexed: true,
+            unique: true, // 1:1 requires uniqueness
+            filterable: options.filterable ?? true,
+            vectorize: false,
+            storeIn: [types_1.StoreLocation.POSTGRES, types_1.StoreLocation.QDRANT_PAYLOAD],
+        });
+    };
+}
+/**
+ * One-to-Many relationship (1:N)
+ * This is informational only - the foreign key exists on the "many" side
+ *
+ * @example
+ * ```typescript
+ * @Collection({ name: "users" })
+ * class User {
+ *   @OneToMany({
+ *     target: () => Post,
+ *     foreignKey: "author_id"
+ *   })
+ *   posts?: Post[];  // Virtual field, no FK created here
+ * }
+ * ```
+ */
+function OneToMany(options) {
+    return function (target, propertyKey) {
+        // OneToMany doesn't create any fields - it's just metadata
+        // The foreign key lives on the "many" side (target collection)
+        // This decorator is mainly for documentation and future query building
+    };
+}
+/**
+ * Many-to-Many relationship (N:N)
+ * Creates a join table to manage the relationship
+ *
+ * @example
+ * ```typescript
+ * @Collection({ name: "posts" })
+ * class Post {
+ *   @ManyToMany({
+ *     target: () => Tag,
+ *     joinTable: "post_tags"
+ *   })
+ *   tags?: Tag[];  // Join table: post_tags(post_id, tag_id)
+ * }
+ * ```
+ */
+function ManyToMany(options) {
+    return function (target, propertyKey) {
+        // ManyToMany relationships require a join table
+        // This is handled by storing an array of IDs in a JSONB field
+        const key = String(propertyKey);
+        const prototype = target;
+        const constructor = Object.getPrototypeOf(prototype).constructor;
+        if (!fieldMetadata.has(constructor)) {
+            fieldMetadata.set(constructor, []);
+        }
+        const fields = fieldMetadata.get(constructor);
+        // Store as array of IDs in JSONB
+        fields.push({
+            name: `${key}_ids`,
+            type: types_1.FieldType.JSON,
+            description: options.description || `Many-to-many relationship with ${key}`,
+            required: false,
+            indexed: false,
+            unique: false,
+            filterable: false,
+            vectorize: false,
+            storeIn: [types_1.StoreLocation.POSTGRES],
+        });
+    };
+}
+//# sourceMappingURL=decorators.js.map

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

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

package/dist/schema-decorators/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Schema Decorators for CortexDB
+ *
+ * Define schemas using TypeScript decorators instead of YAML files.
+ */
+export { Collection, Field, FieldOptions, CollectionOptions, ManyToOne, OneToOne, OneToMany, ManyToMany, ManyToOneOptions, OneToOneOptions, OneToManyOptions, ManyToManyOptions, RelationOptions, } from './decorators';
+export { loadTypeScriptSchemasSync, LoadedCollection } from './loader';
+export { validateSchema, formatValidationErrors, ValidationError, ValidationResult } from './validator';
+export { FieldType, StoreLocation, FieldDefinition, CollectionConfig } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema-decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema-decorators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,UAAU,EACV,KAAK,EACL,YAAY,EACZ,iBAAiB,EAEjB,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/schema-decorators/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Schema Decorators for CortexDB
+ *
+ * Define schemas using TypeScript decorators instead of YAML files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreLocation = exports.FieldType = exports.formatValidationErrors = exports.validateSchema = exports.loadTypeScriptSchemasSync = exports.ManyToMany = exports.OneToMany = exports.OneToOne = exports.ManyToOne = exports.Field = exports.Collection = void 0;
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "Collection", { enumerable: true, get: function () { return decorators_1.Collection; } });
+Object.defineProperty(exports, "Field", { enumerable: true, get: function () { return decorators_1.Field; } });
+// Relationship decorators
+Object.defineProperty(exports, "ManyToOne", { enumerable: true, get: function () { return decorators_1.ManyToOne; } });
+Object.defineProperty(exports, "OneToOne", { enumerable: true, get: function () { return decorators_1.OneToOne; } });
+Object.defineProperty(exports, "OneToMany", { enumerable: true, get: function () { return decorators_1.OneToMany; } });
+Object.defineProperty(exports, "ManyToMany", { enumerable: true, get: function () { return decorators_1.ManyToMany; } });
+var loader_1 = require("./loader");
+Object.defineProperty(exports, "loadTypeScriptSchemasSync", { enumerable: true, get: function () { return loader_1.loadTypeScriptSchemasSync; } });
+var validator_1 = require("./validator");
+Object.defineProperty(exports, "validateSchema", { enumerable: true, get: function () { return validator_1.validateSchema; } });
+Object.defineProperty(exports, "formatValidationErrors", { enumerable: true, get: function () { return validator_1.formatValidationErrors; } });
+var types_1 = require("../types");
+Object.defineProperty(exports, "FieldType", { enumerable: true, get: function () { return types_1.FieldType; } });
+Object.defineProperty(exports, "StoreLocation", { enumerable: true, get: function () { return types_1.StoreLocation; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema-decorators/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAesB;AAdpB,wGAAA,UAAU,OAAA;AACV,mGAAA,KAAK,OAAA;AAGL,0BAA0B;AAC1B,uGAAA,SAAS,OAAA;AACT,sGAAA,QAAQ,OAAA;AACR,uGAAA,SAAS,OAAA;AACT,wGAAA,UAAU,OAAA;AAOZ,mCAAuE;AAA9D,mHAAA,yBAAyB,OAAA;AAClC,yCAAwG;AAA/F,2GAAA,cAAc,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAC/C,kCAAuF;AAA9E,kGAAA,SAAS,OAAA;AAAE,sGAAA,aAAa,OAAA"}

package/dist/schema-decorators/loader.d.ts

@@ -0,0 +1,12 @@
+import { FieldDefinition, CollectionConfig } from '../types';
+export interface LoadedCollection {
+    name: string;
+    description?: string;
+    database?: string;
+    config?: CollectionConfig;
+    fields: FieldDefinition[];
+    /** Original TypeScript class name (for validation) */
+    className?: string;
+}
+export declare function loadTypeScriptSchemasSync(schemaDir: string): LoadedCollection[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/schema-decorators/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/schema-decorators/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAa7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0BD,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkG/E"}

package/dist/schema-decorators/loader.js

@@ -0,0 +1,161 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTypeScriptSchemasSync = loadTypeScriptSchemasSync;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const decorators_1 = require("./decorators");
+let tsNodeAvailable = false;
+try {
+    // Try to resolve ts-node from the current working directory first
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require.resolve('ts-node', { paths: [process.cwd(), __dirname] });
+    tsNodeAvailable = true;
+}
+catch {
+    // ts-node not available
+}
+function registerTsNode() {
+    if (tsNodeAvailable && !global.__tsNodeRegistered) {
+        try {
+            // Try to load ts-node from the current working directory
+            const tsNodePath = require.resolve('ts-node', { paths: [process.cwd(), __dirname] });
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const tsNode = require(tsNodePath);
+            tsNode.register({
+                transpileOnly: true,
+                compilerOptions: {
+                    module: 'commonjs',
+                    target: 'es2020',
+                    esModuleInterop: true,
+                    experimentalDecorators: true,
+                    emitDecoratorMetadata: true,
+                },
+            });
+            global.__tsNodeRegistered = true;
+        }
+        catch {
+            // ts-node registration failed
+        }
+    }
+}
+function loadTypeScriptSchemasSync(schemaDir) {
+    if (!fs.existsSync(schemaDir)) {
+        throw new Error(`Schema directory not found: ${schemaDir}`);
+    }
+    registerTsNode();
+    (0, decorators_1.clearMetadata)();
+    const files = fs.readdirSync(schemaDir).filter((file) => file.endsWith('.ts') && !file.endsWith('.d.ts'));
+    if (files.length === 0) {
+        throw new Error(`No TypeScript schema files found in ${schemaDir}`);
+    }
+    const collections = [];
+    for (const file of files) {
+        const fullPath = path.resolve(schemaDir, file);
+        delete require.cache[fullPath];
+        const jsPath = fullPath.replace(/\.ts$/, '.js');
+        if (fs.existsSync(jsPath)) {
+            delete require.cache[jsPath];
+        }
+    }
+    for (const file of files) {
+        const fullPath = path.resolve(schemaDir, file);
+        try {
+            if (tsNodeAvailable) {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                require(fullPath);
+            }
+            else {
+                const jsPath = fullPath.replace(/\.ts$/, '.js');
+                if (fs.existsSync(jsPath)) {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    require(jsPath);
+                }
+                else {
+                    throw new Error(`Cannot load ${file}: ts-node not available and no compiled .js file found`);
+                }
+            }
+        }
+        catch (error) {
+            const err = error;
+            console.warn(`Warning: Failed to load ${file}: ${err.message || 'Unknown error'}`);
+            continue;
+        }
+    }
+    const collectionMeta = (0, decorators_1.getCollectionMetadata)();
+    for (const [className, collectionInfo] of collectionMeta.entries()) {
+        let classConstructor = null;
+        for (const file of files) {
+            const fullPath = path.resolve(schemaDir, file);
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const cached = require.cache[fullPath] || require.cache[fullPath.replace(/\.ts$/, '.js')];
+                if (cached && cached.exports) {
+                    if (cached.exports[className]) {
+                        classConstructor = cached.exports[className];
+                        break;
+                    }
+                    if (cached.exports.default && cached.exports.default.name === className) {
+                        classConstructor = cached.exports.default;
+                        break;
+                    }
+                }
+            }
+            catch {
+                // Continue searching
+            }
+        }
+        if (!classConstructor) {
+            console.warn(`Warning: Could not find class constructor for ${className}`);
+            continue;
+        }
+        const fieldMeta = (0, decorators_1.getFieldMetadata)(classConstructor);
+        if (!fieldMeta || fieldMeta.length === 0) {
+            console.warn(`Warning: No fields found for collection ${collectionInfo.name}`);
+            continue;
+        }
+        const fields = fieldMeta.map(decorators_1.fieldMetadataToDefinition);
+        collections.push({
+            name: collectionInfo.name,
+            description: collectionInfo.description,
+            database: collectionInfo.database,
+            config: collectionInfo.config,
+            fields,
+            className,
+        });
+    }
+    return collections;
+}
+//# sourceMappingURL=loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/schema-decorators/loader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,8DAkGC;AAnJD,uCAAyB;AACzB,2CAA6B;AAE7B,6CAAiH;AAEjH,IAAI,eAAe,GAAG,KAAK,CAAC;AAC5B,IAAI,CAAC;IACH,kEAAkE;IAClE,iEAAiE;IACjE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAClE,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAAC,MAAM,CAAC;IACP,wBAAwB;AAC1B,CAAC;AAYD,SAAS,cAAc;IACrB,IAAI,eAAe,IAAI,CAAE,MAA2C,CAAC,kBAAkB,EAAE,CAAC;QACxF,IAAI,CAAC;YACH,yDAAyD;YACzD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YACrF,iEAAiE;YACjE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC;gBACd,aAAa,EAAE,IAAI;gBACnB,eAAe,EAAE;oBACf,MAAM,EAAE,UAAU;oBAClB,MAAM,EAAE,QAAQ;oBAChB,eAAe,EAAE,IAAI;oBACrB,sBAAsB,EAAE,IAAI;oBAC5B,qBAAqB,EAAE,IAAI;iBAC5B;aACF,CAAC,CAAC;YACF,MAA2C,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,yBAAyB,CAAC,SAAiB;IACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,EAAE,CAAC;IACjB,IAAA,0BAAa,GAAE,CAAC;IAEhB,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAC5C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC1D,CAAC;IAEF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,WAAW,GAAuB,EAAE,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC;YACH,IAAI,eAAe,EAAE,CAAC;gBACpB,iEAAiE;gBACjE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAChD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,iEAAiE;oBACjE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,wDAAwD,CAAC,CAAC;gBAC/F,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,KAA6B,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,2BAA2B,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;YACnF,SAAS;QACX,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,kCAAqB,GAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;QACnE,IAAI,gBAAgB,GAA8B,IAAI,CAAC;QAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC/C,IAAI,CAAC;gBACH,iEAAiE;gBACjE,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC1F,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC7B,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC9B,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;wBAC7C,MAAM;oBACR,CAAC;oBACD,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;wBACxE,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;wBAC1C,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,iDAAiD,SAAS,EAAE,CAAC,CAAC;YAC3E,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,6BAAgB,EAAC,gBAAgB,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,2CAA2C,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/E,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAsB,SAAS,CAAC,GAAG,CAAC,sCAAyB,CAAC,CAAC;QAE3E,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,QAAQ,EAAE,cAAc,CAAC,QAAQ;YACjC,MAAM,EAAE,cAAc,CAAC,MAAM;YAC7B,MAAM;YACN,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/schema-decorators/validator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Schema Validator for CortexDB TypeScript Schemas
+ *
+ * Validates relationships and schema consistency, similar to Prisma's validation.
+ */
+import { LoadedCollection } from './loader';
+export interface ValidationError {
+    collection: string;
+    field?: string;
+    message: string;
+    suggestion?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+/**
+ * Validate all loaded collections for consistency
+ */
+export declare function validateSchema(collections: LoadedCollection[]): ValidationResult;
+/**
+ * Format validation errors for display
+ */
+export declare function formatValidationErrors(result: ValidationResult): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/schema-decorators/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/schema-decorators/validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAiKhF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkCvE"}