@objectql/core 1.3.1 → 1.5.0

package/dist/validator.js

@@ -0,0 +1,461 @@
+"use strict";
+/**
+ * Validation engine for ObjectQL.
+ * Executes validation rules based on metadata configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validator = void 0;
+/**
+ * Validator class that executes validation rules.
+ */
+class Validator {
+    constructor(options = {}) {
+        this.options = {
+            language: options.language || 'en',
+            languageFallback: options.languageFallback || ['en', 'zh-CN'],
+        };
+    }
+    /**
+     * Validate a record against a set of rules.
+     */
+    async validate(rules, context) {
+        const results = [];
+        for (const rule of rules) {
+            // Check if rule should be applied
+            if (!this.shouldApplyRule(rule, context)) {
+                continue;
+            }
+            // Execute validation based on rule type
+            let result;
+            try {
+                switch (rule.type) {
+                    case 'cross_field':
+                        result = await this.validateCrossField(rule, context);
+                        break;
+                    case 'state_machine':
+                        result = await this.validateStateMachine(rule, context);
+                        break;
+                    case 'unique':
+                        result = await this.validateUniqueness(rule, context);
+                        break;
+                    case 'business_rule':
+                        result = await this.validateBusinessRule(rule, context);
+                        break;
+                    case 'custom':
+                        result = await this.validateCustom(rule, context);
+                        break;
+                    default:
+                        // Generic validation
+                        result = {
+                            rule: rule.name,
+                            valid: true,
+                        };
+                }
+            }
+            catch (error) {
+                result = {
+                    rule: rule.name,
+                    valid: false,
+                    message: error instanceof Error ? error.message : 'Validation error',
+                    severity: rule.severity || 'error',
+                };
+            }
+            results.push(result);
+        }
+        // Categorize results
+        const errors = results.filter(r => !r.valid && r.severity === 'error');
+        const warnings = results.filter(r => !r.valid && r.severity === 'warning');
+        const info = results.filter(r => !r.valid && r.severity === 'info');
+        return {
+            valid: errors.length === 0,
+            results,
+            errors,
+            warnings,
+            info,
+        };
+    }
+    /**
+     * Validate field-level rules.
+     */
+    async validateField(fieldName, fieldConfig, value, context) {
+        const results = [];
+        // Required field validation
+        if (fieldConfig.required && (value === null || value === undefined || value === '')) {
+            results.push({
+                rule: `${fieldName}_required`,
+                valid: false,
+                message: fieldConfig.validation?.message || `${fieldConfig.label || fieldName} is required`,
+                severity: 'error',
+                fields: [fieldName],
+            });
+        }
+        // Skip further validation if value is empty and not required
+        if (value === null || value === undefined || value === '') {
+            return results;
+        }
+        // Type-specific validation
+        if (fieldConfig.validation) {
+            const validation = fieldConfig.validation;
+            // Email format
+            if (validation.format === 'email') {
+                // NOTE: This is a basic email validation regex. For production use,
+                // consider using a more comprehensive email validation library or regex
+                // that handles international domains, quoted strings, etc.
+                const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+                if (!emailRegex.test(value)) {
+                    results.push({
+                        rule: `${fieldName}_email_format`,
+                        valid: false,
+                        message: validation.message || 'Invalid email format',
+                        severity: 'error',
+                        fields: [fieldName],
+                    });
+                }
+            }
+            // URL format
+            if (validation.format === 'url') {
+                try {
+                    const url = new URL(value);
+                    if (validation.protocols && !validation.protocols.includes(url.protocol.replace(':', ''))) {
+                        results.push({
+                            rule: `${fieldName}_url_protocol`,
+                            valid: false,
+                            message: validation.message || `URL must use one of: ${validation.protocols.join(', ')}`,
+                            severity: 'error',
+                            fields: [fieldName],
+                        });
+                    }
+                }
+                catch {
+                    results.push({
+                        rule: `${fieldName}_url_format`,
+                        valid: false,
+                        message: validation.message || 'Invalid URL format',
+                        severity: 'error',
+                        fields: [fieldName],
+                    });
+                }
+            }
+            // Pattern validation (supports both pattern and deprecated regex)
+            const patternValue = validation.pattern ?? validation.regex;
+            if (patternValue) {
+                try {
+                    const pattern = new RegExp(patternValue);
+                    if (!pattern.test(String(value))) {
+                        results.push({
+                            rule: `${fieldName}_pattern`,
+                            valid: false,
+                            message: validation.message || 'Value does not match required pattern',
+                            severity: 'error',
+                            fields: [fieldName],
+                        });
+                    }
+                }
+                catch (error) {
+                    results.push({
+                        rule: `${fieldName}_pattern`,
+                        valid: false,
+                        message: `Invalid regex pattern: ${patternValue}`,
+                        severity: 'error',
+                        fields: [fieldName],
+                    });
+                }
+            }
+            // Min/Max validation
+            if (validation.min !== undefined && value < validation.min) {
+                results.push({
+                    rule: `${fieldName}_min`,
+                    valid: false,
+                    message: validation.message || `Value must be at least ${validation.min}`,
+                    severity: 'error',
+                    fields: [fieldName],
+                });
+            }
+            if (validation.max !== undefined && value > validation.max) {
+                results.push({
+                    rule: `${fieldName}_max`,
+                    valid: false,
+                    message: validation.message || `Value must be at most ${validation.max}`,
+                    severity: 'error',
+                    fields: [fieldName],
+                });
+            }
+            // Length validation
+            const strValue = String(value);
+            if (validation.min_length !== undefined && strValue.length < validation.min_length) {
+                results.push({
+                    rule: `${fieldName}_min_length`,
+                    valid: false,
+                    message: validation.message || `Must be at least ${validation.min_length} characters`,
+                    severity: 'error',
+                    fields: [fieldName],
+                });
+            }
+            if (validation.max_length !== undefined && strValue.length > validation.max_length) {
+                results.push({
+                    rule: `${fieldName}_max_length`,
+                    valid: false,
+                    message: validation.message || `Must be at most ${validation.max_length} characters`,
+                    severity: 'error',
+                    fields: [fieldName],
+                });
+            }
+        }
+        // Legacy min/max from fieldConfig
+        if (fieldConfig.min !== undefined && value < fieldConfig.min) {
+            results.push({
+                rule: `${fieldName}_min`,
+                valid: false,
+                message: `Value must be at least ${fieldConfig.min}`,
+                severity: 'error',
+                fields: [fieldName],
+            });
+        }
+        if (fieldConfig.max !== undefined && value > fieldConfig.max) {
+            results.push({
+                rule: `${fieldName}_max`,
+                valid: false,
+                message: `Value must be at most ${fieldConfig.max}`,
+                severity: 'error',
+                fields: [fieldName],
+            });
+        }
+        return results;
+    }
+    /**
+     * Check if a rule should be applied based on triggers and conditions.
+     */
+    shouldApplyRule(rule, context) {
+        // Check trigger
+        if (rule.trigger && !rule.trigger.includes(context.operation)) {
+            return false;
+        }
+        // Check fields (for updates)
+        if (rule.fields && rule.fields.length > 0 && context.changedFields) {
+            const hasChangedField = rule.fields.some(f => context.changedFields.includes(f));
+            if (!hasChangedField) {
+                return false;
+            }
+        }
+        // Check apply_when condition
+        if (rule.apply_when) {
+            return this.evaluateCondition(rule.apply_when, context.record);
+        }
+        return true;
+    }
+    /**
+     * Validate cross-field rule.
+     */
+    async validateCrossField(rule, context) {
+        if (!rule.rule) {
+            return { rule: rule.name, valid: true };
+        }
+        const valid = this.evaluateCondition(rule.rule, context.record);
+        return {
+            rule: rule.name,
+            valid,
+            message: valid ? undefined : this.formatMessage(rule.message, context.record),
+            error_code: rule.error_code,
+            severity: rule.severity || 'error',
+        };
+    }
+    /**
+     * Validate state machine transitions.
+     */
+    async validateStateMachine(rule, context) {
+        // Only validate on update
+        if (context.operation !== 'update' || !context.previousRecord) {
+            return { rule: rule.name, valid: true };
+        }
+        const oldState = context.previousRecord[rule.field];
+        const newState = context.record[rule.field];
+        // If state hasn't changed, validation passes
+        if (oldState === newState) {
+            return { rule: rule.name, valid: true };
+        }
+        // Check if transition is allowed
+        const transitions = rule.transitions?.[oldState];
+        if (!transitions) {
+            return {
+                rule: rule.name,
+                valid: false,
+                message: this.formatMessage(rule.message, { old_status: oldState, new_status: newState }),
+                error_code: rule.error_code,
+                severity: rule.severity || 'error',
+                fields: [rule.field],
+            };
+        }
+        // Handle both array and object format
+        let allowedNext = [];
+        if (Array.isArray(transitions)) {
+            allowedNext = transitions;
+        }
+        else if (typeof transitions === 'object' && 'allowed_next' in transitions) {
+            allowedNext = transitions.allowed_next || [];
+        }
+        const isAllowed = allowedNext.includes(newState);
+        return {
+            rule: rule.name,
+            valid: isAllowed,
+            message: isAllowed ? undefined : this.formatMessage(rule.message, { old_status: oldState, new_status: newState }),
+            error_code: rule.error_code,
+            severity: rule.severity || 'error',
+            fields: [rule.field],
+        };
+    }
+    /**
+     * Validate uniqueness (stub - requires database access).
+     */
+    async validateUniqueness(rule, context) {
+        // TODO: Implement database query for uniqueness check
+        // This requires access to the data layer (driver/repository)
+        // Stub: Pass silently until implementation is complete
+        return {
+            rule: rule.name,
+            valid: true,
+        };
+    }
+    /**
+     * Validate business rule (stub - requires complex logic).
+     */
+    async validateBusinessRule(rule, context) {
+        // TODO: Implement business rule evaluation
+        // This requires expression parsing and relationship resolution
+        // Stub: Pass silently until implementation is complete
+        return {
+            rule: rule.name,
+            valid: true,
+        };
+    }
+    /**
+     * Validate custom rule (stub - requires function execution).
+     */
+    async validateCustom(rule, context) {
+        // TODO: Implement custom validator execution
+        // This requires safe function evaluation
+        // Stub: Pass silently until implementation is complete
+        return {
+            rule: rule.name,
+            valid: true,
+        };
+    }
+    /**
+     * Evaluate a validation condition.
+     */
+    evaluateCondition(condition, record) {
+        // Handle logical operators
+        if (condition.all_of) {
+            return condition.all_of.every(c => this.evaluateCondition(c, record));
+        }
+        if (condition.any_of) {
+            return condition.any_of.some(c => this.evaluateCondition(c, record));
+        }
+        // Handle expression
+        if (condition.expression) {
+            // TODO: Implement safe expression evaluation
+            return true;
+        }
+        // Handle field comparison
+        if (condition.field && condition.operator !== undefined) {
+            const fieldValue = record[condition.field];
+            // Use compare_to if specified (cross-field comparison), otherwise use value
+            const compareValue = condition.compare_to !== undefined
+                ? record[condition.compare_to]
+                : condition.value;
+            return this.compareValues(fieldValue, condition.operator, compareValue);
+        }
+        return true;
+    }
+    /**
+     * Compare two values using an operator.
+     */
+    compareValues(a, operator, b) {
+        switch (operator) {
+            case '=':
+                return a === b;
+            case '!=':
+                return a !== b;
+            case '>':
+                return a > b;
+            case '>=':
+                return a >= b;
+            case '<':
+                return a < b;
+            case '<=':
+                return a <= b;
+            case 'in':
+                return Array.isArray(b) && b.includes(a);
+            case 'not_in':
+                return Array.isArray(b) && !b.includes(a);
+            case 'contains': {
+                if (a == null || b == null) {
+                    return false;
+                }
+                const strA = String(a);
+                const strB = String(b);
+                return strA.includes(strB);
+            }
+            case 'not_contains': {
+                if (a == null || b == null) {
+                    return false;
+                }
+                const strA = String(a);
+                const strB = String(b);
+                return !strA.includes(strB);
+            }
+            case 'starts_with': {
+                if (a == null || b == null) {
+                    return false;
+                }
+                const strA = String(a);
+                const strB = String(b);
+                return strA.startsWith(strB);
+            }
+            case 'ends_with': {
+                if (a == null || b == null) {
+                    return false;
+                }
+                const strA = String(a);
+                const strB = String(b);
+                return strA.endsWith(strB);
+            }
+            default:
+                return false;
+        }
+    }
+    /**
+     * Format validation message with template variables.
+     */
+    formatMessage(message, context) {
+        // Handle i18n messages
+        if (typeof message === 'object') {
+            // Try preferred language first
+            const preferredLanguage = this.options.language ?? 'en';
+            let messageText = message[preferredLanguage];
+            // Try fallback languages if preferred not available
+            if (!messageText && this.options.languageFallback) {
+                for (const lang of this.options.languageFallback) {
+                    if (message[lang]) {
+                        messageText = message[lang];
+                        break;
+                    }
+                }
+            }
+            // Fallback to first available message
+            message = messageText || Object.values(message)[0];
+        }
+        // Replace template variables
+        return message.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (match, path) => {
+            const value = this.getNestedValue(context, path);
+            return value !== undefined ? String(value) : match;
+        });
+    }
+    /**
+     * Get nested value from object by path.
+     */
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => current?.[key], obj);
+    }
+}
+exports.Validator = Validator;
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/jest.config.js

@@ -3,6 +3,11 @@ module.exports = {
   testEnvironment: 'node',
   testMatch: ['**/test/**/*.test.ts'],
   moduleNameMapper: {
-    '^@objectql/types$': '<rootDir>/../types/src',
+    '^@objectql/(.*)$': '<rootDir>/../$1/src',
+  },
+  transform: {
+    '^.+\\.ts$': ['ts-jest', {
+      isolatedModules: true,
+    }],
   },
 };

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@objectql/core",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
     "fast-glob": "^3.3.2",
     "js-yaml": "^4.1.1",
-    "@objectql/types": "1.3.1",
-    "@objectql/driver-remote": "1.3.1"
+    "@objectql/types": "1.5.0",
+    "@objectql/driver-remote": "1.5.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/app.ts

@@ -14,6 +14,9 @@ import {
     ActionContext,
     LoaderPlugin
 } from '@objectql/types';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
 import { ObjectLoader } from './loader';
 import { ObjectRepository } from './repository';
 import { loadPlugin } from './plugin';
@@ -106,6 +109,50 @@ export class ObjectQL implements IObjectQL {
         this.loader.use(plugin);
     }
 
+    async updateMetadata(type: string, id: string, content: any): Promise<void> {
+        // Use registry to find the entry so we can get the file path
+        const entry = this.metadata.getEntry(type, id);
+        if (!entry) {
+            throw new Error(`Metadata ${type}:${id} not found`);
+        }
+
+        if (!entry.path) {
+            throw new Error('Cannot update: Metadata source file not found (in-memory only?)');
+        }
+
+        // Safety Check: Prevent writing to node_modules
+        if (entry.path.includes('node_modules')) {
+            throw new Error(`Cannot update metadata ${type}:${id}: File is inside node_modules (read-only package).`);
+        }
+
+        // Check file extension
+        const ext = path.extname(entry.path).toLowerCase();
+        let newContent = '';
+
+        if (ext === '.yml' || ext === '.yaml') {
+            newContent = yaml.dump(content);
+        } else if (ext === '.json') {
+            newContent = JSON.stringify(content, null, 2);
+        } else {
+            throw new Error(`Cannot update: Unsupported file format ${ext} (only .yml, .yaml, .json supported)`);
+        }
+
+        // Write file
+        try {
+            await fs.promises.chmod(entry.path, 0o666).catch(() => {}); // Try to ensure writable
+            await fs.promises.writeFile(entry.path, newContent, 'utf8');
+        } catch (e: any) {
+            throw new Error(`Failed to write file ${entry.path}: ${e.message}`);
+        }
+
+        // Update registry in-memory
+        entry.content = content;
+        
+        // If it's an object update, we might need some re-processing? 
+        // For now, assume a restart or reload is needed for deep schema changes, 
+        // but simple property updates are reflected immediately in registry.
+    }
+
     createContext(options: ObjectQLContextOptions): ObjectQLContext {
         const ctx: ObjectQLContext = {
             userId: options.userId,
@@ -253,5 +300,54 @@ export class ObjectQL implements IObjectQL {
                 await driver.init(objects);
             }
         }
+
+        // 6. Process Initial Data
+        await this.processInitialData();
+    }
+
+    private async processInitialData() {
+        const dataEntries = this.metadata.list<any>('data');
+        if (dataEntries.length === 0) return;
+
+        console.log(`Processing ${dataEntries.length} initial data files...`);
+        
+        // We need a system context to write data
+        const ctx = this.createContext({ isSystem: true });
+
+        for (const entry of dataEntries) {
+            // Expected format:
+            // object: User
+            // records:
+            //   - name: Admin
+            //     email: admin@example.com
+            
+            const objectName = entry.object;
+            const records = entry.records;
+
+            if (!objectName || !records || !Array.isArray(records)) {
+                console.warn(`Skipping invalid data entry:`, entry);
+                continue;
+            }
+
+            const repo = ctx.object(objectName);
+            
+            for (const record of records) {
+                try {
+                    // Check existence if a unique key is provided?
+                    // For now, let's assume if it has an ID, we check it.
+                    // Or we could try to find existing record by some key matching logic.
+                    // Simple approach: create. If it fails (constraint), ignore.
+                    
+                    // Actually, a better approach for initial data is "upsert" or "create if not exists".
+                    // But without unique keys defined in data, we can't reliably dedup.
+                    // Let's try to 'create' and catch errors.
+                    await repo.create(record);
+                    console.log(`Initialized record for ${objectName}`);
+                } catch (e: any) {
+                    // Ignore duplicate key errors silently-ish
+                    // console.warn(`Failed to insert initial data for ${objectName}: ${e.message}`);
+                }
+            }
+        }
     }
 }

package/src/index.ts

@@ -7,3 +7,4 @@ export * from './remote';
 export * from './action';
 export * from './hook';
 export * from './object';
+export * from './validator';