@objectql/core 4.2.0 → 4.2.2

package/dist/optimizations/SQLQueryOptimizer.js

@@ -1,265 +0,0 @@
-"use strict";
-/**
- * ObjectQL
- * Copyright (c) 2026-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SQLQueryOptimizer = void 0;
-/**
- * SQL Query Optimizer
- *
- * Improvement: SQL-aware optimization with index hints and join reordering.
- * Analyzes query patterns and schema to generate optimal SQL.
- *
- * Expected: 2-5x faster queries on large datasets
- */
-class SQLQueryOptimizer {
-    constructor() {
-        this.schemas = new Map();
-    }
-    /**
-     * Register a schema with index information
-     */
-    registerSchema(schema) {
-        this.schemas.set(schema.name, schema);
-    }
-    /**
-     * Check if a field has an index
-     */
-    hasIndex(objectName, fieldName) {
-        const schema = this.schemas.get(objectName);
-        if (!schema || !schema.indexes)
-            return false;
-        return schema.indexes.some(index => index.fields.includes(fieldName));
-    }
-    /**
-     * Get the best index for given filter fields
-     */
-    getBestIndex(objectName, filterFields) {
-        const schema = this.schemas.get(objectName);
-        if (!schema || !schema.indexes)
-            return null;
-        // Find indexes that cover the filter fields
-        const candidateIndexes = schema.indexes.filter(index => {
-            // Check if index covers any of the filter fields
-            return filterFields.some(field => index.fields.includes(field));
-        });
-        if (candidateIndexes.length === 0)
-            return null;
-        // Prefer indexes that match more filter fields
-        candidateIndexes.sort((a, b) => {
-            const aMatches = a.fields.filter(f => filterFields.includes(f)).length;
-            const bMatches = b.fields.filter(f => filterFields.includes(f)).length;
-            return bMatches - aMatches;
-        });
-        return candidateIndexes[0];
-    }
-    /**
-     * Extract filter fields from filter conditions
-     */
-    extractFilterFields(filters) {
-        const fields = [];
-        const extract = (obj) => {
-            if (!obj || typeof obj !== 'object')
-                return;
-            for (const key of Object.keys(obj)) {
-                if (!key.startsWith('$')) {
-                    fields.push(key);
-                }
-                if (typeof obj[key] === 'object') {
-                    extract(obj[key]);
-                }
-            }
-        };
-        extract(filters);
-        return [...new Set(fields)]; // Remove duplicates
-    }
-    /**
-     * Optimize join type based on query characteristics
-     *
-     * Note: This method expects filter fields in one of two formats:
-     * 1. Table-prefixed: "tableName.fieldName" (e.g., "accounts.type")
-     * 2. Simple field name: "fieldName" (checked against joined table schema)
-     *
-     * Multi-level qualification (e.g., "schema.table.field") is not currently supported.
-     */
-    optimizeJoinType(join, ast) {
-        // If we're filtering on the joined table, we can use INNER JOIN
-        if (ast.filters) {
-            const filterFields = this.extractFilterFields(ast.filters);
-            // Check if any filter field references the joined table
-            const hasFilterOnJoinTable = filterFields.some(field => {
-                // Handle table-prefixed fields like "accounts.type"
-                if (field.includes('.')) {
-                    const parts = field.split('.');
-                    // Only consider the first part as table name for simplicity
-                    // This assumes format: "table.field" not "schema.table.field"
-                    if (parts.length === 2 && parts[0] === join.table) {
-                        return true;
-                    }
-                    // If more than 2 parts or table doesn't match, skip this field
-                    return false;
-                }
-                // Also check if the field exists in the joined table schema (non-prefixed)
-                const schema = this.schemas.get(join.table);
-                if (schema) {
-                    return schema.fields[field] !== undefined;
-                }
-                return false;
-            });
-            if (hasFilterOnJoinTable) {
-                return 'inner'; // Convert LEFT to INNER for better performance
-            }
-        }
-        return join.type;
-    }
-    /**
-     * Optimize a query AST to SQL
-     */
-    optimize(ast) {
-        const schema = this.schemas.get(ast.object);
-        if (!schema) {
-            // Fallback to basic SQL generation
-            return this.generateBasicSQL(ast);
-        }
-        let sql = 'SELECT ';
-        // Fields
-        if (ast.fields && ast.fields.length > 0) {
-            sql += ast.fields.join(', ');
-        }
-        else {
-            sql += '*';
-        }
-        sql += ` FROM ${ast.object}`;
-        // Index hints
-        if (ast.filters) {
-            const filterFields = this.extractFilterFields(ast.filters);
-            const bestIndex = this.getBestIndex(ast.object, filterFields);
-            if (bestIndex) {
-                // Add index hint for MySQL/MariaDB
-                sql += ` USE INDEX (${bestIndex.name})`;
-            }
-        }
-        // Optimized joins
-        if (ast.joins && ast.joins.length > 0) {
-            for (const join of ast.joins) {
-                const optimizedType = this.optimizeJoinType(join, ast);
-                sql += ` ${optimizedType.toUpperCase()} JOIN ${join.table}`;
-                // Simplified join condition
-                if (typeof join.on === 'string') {
-                    sql += ` ON ${join.on}`;
-                }
-            }
-        }
-        // WHERE clause
-        if (ast.filters) {
-            sql += ' WHERE ' + this.filtersToSQL(ast.filters);
-        }
-        // ORDER BY
-        if (ast.sort && ast.sort.length > 0) {
-            sql += ' ORDER BY ';
-            sql += ast.sort.map(s => `${s.field} ${s.order.toUpperCase()}`).join(', ');
-        }
-        // LIMIT and OFFSET
-        if (ast.limit !== undefined) {
-            sql += ` LIMIT ${ast.limit}`;
-        }
-        if (ast.offset !== undefined) {
-            sql += ` OFFSET ${ast.offset}`;
-        }
-        return sql;
-    }
-    /**
-     * Convert filter object to SQL WHERE clause
-     */
-    filtersToSQL(filters) {
-        if (typeof filters === 'string') {
-            return filters;
-        }
-        // Simplified filter conversion
-        const conditions = [];
-        for (const [key, value] of Object.entries(filters)) {
-            if (key === '$and') {
-                const subconditions = value.map(f => this.filtersToSQL(f));
-                conditions.push(`(${subconditions.join(' AND ')})`);
-            }
-            else if (key === '$or') {
-                const subconditions = value.map(f => this.filtersToSQL(f));
-                conditions.push(`(${subconditions.join(' OR ')})`);
-            }
-            else if (!key.startsWith('$')) {
-                // Field condition
-                if (typeof value === 'object' && value !== null) {
-                    for (const [op, val] of Object.entries(value)) {
-                        switch (op) {
-                            case '$eq':
-                                conditions.push(`${key} = '${val}'`);
-                                break;
-                            case '$ne':
-                                conditions.push(`${key} != '${val}'`);
-                                break;
-                            case '$gt':
-                                conditions.push(`${key} > '${val}'`);
-                                break;
-                            case '$gte':
-                                conditions.push(`${key} >= '${val}'`);
-                                break;
-                            case '$lt':
-                                conditions.push(`${key} < '${val}'`);
-                                break;
-                            case '$lte':
-                                conditions.push(`${key} <= '${val}'`);
-                                break;
-                            case '$in':
-                                const inValues = val.map(v => `'${v}'`).join(', ');
-                                conditions.push(`${key} IN (${inValues})`);
-                                break;
-                        }
-                    }
-                }
-                else {
-                    conditions.push(`${key} = '${value}'`);
-                }
-            }
-        }
-        return conditions.join(' AND ');
-    }
-    /**
-     * Fallback: generate basic SQL without optimizations
-     */
-    generateBasicSQL(ast) {
-        let sql = 'SELECT ';
-        if (ast.fields && ast.fields.length > 0) {
-            sql += ast.fields.join(', ');
-        }
-        else {
-            sql += '*';
-        }
-        sql += ` FROM ${ast.object}`;
-        if (ast.filters) {
-            sql += ' WHERE ' + this.filtersToSQL(ast.filters);
-        }
-        if (ast.sort && ast.sort.length > 0) {
-            sql += ' ORDER BY ';
-            sql += ast.sort.map(s => `${s.field} ${s.order.toUpperCase()}`).join(', ');
-        }
-        if (ast.limit !== undefined) {
-            sql += ` LIMIT ${ast.limit}`;
-        }
-        if (ast.offset !== undefined) {
-            sql += ` OFFSET ${ast.offset}`;
-        }
-        return sql;
-    }
-    /**
-     * Clear all registered schemas
-     */
-    clearSchemas() {
-        this.schemas.clear();
-    }
-}
-exports.SQLQueryOptimizer = SQLQueryOptimizer;
-//# sourceMappingURL=SQLQueryOptimizer.js.map

package/dist/optimizations/SQLQueryOptimizer.js.map

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

package/dist/optimizations/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * ObjectQL
- * Copyright (c) 2026-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/**
- * Kernel Optimizations Module
- *
- * This module contains 10 key optimizations for the ObjectQL kernel:
- *
- * 1. OptimizedMetadataRegistry - O(k) package uninstall with secondary indexes
- * 2. QueryCompiler - LRU cache for compiled query plans
- * 3. CompiledHookManager - Pre-compiled hook pipelines
- * 4. GlobalConnectionPool - Kernel-level connection pooling
- * 5. OptimizedValidationEngine - Compiled validation rules
- * 6. LazyMetadataLoader - On-demand metadata loading with predictive preload
- * 7. DependencyGraph - DAG-based dependency resolution
- * 8. SQLQueryOptimizer - SQL-aware query optimization with index hints
- *
- * Note: TypeScript type generation optimization (#7) and memory-mapped storage (#10)
- * are not included in this release for compatibility and complexity reasons.
- */
-export { OptimizedMetadataRegistry } from './OptimizedMetadataRegistry';
-export { QueryCompiler, type CompiledQuery } from './QueryCompiler';
-export { CompiledHookManager, type Hook } from './CompiledHookManager';
-export { GlobalConnectionPool, type Connection, type PoolLimits } from './GlobalConnectionPool';
-export { OptimizedValidationEngine, type ValidatorFunction, type ValidationSchema } from './OptimizedValidationEngine';
-export { LazyMetadataLoader, type ObjectMetadata, type MetadataLoader } from './LazyMetadataLoader';
-export { DependencyGraph, type DependencyEdge, type DependencyType } from './DependencyGraph';
-export { SQLQueryOptimizer, type IndexMetadata, type SchemaWithIndexes, type OptimizableQueryAST } from './SQLQueryOptimizer';

package/dist/optimizations/index.js

@@ -1,44 +0,0 @@
-"use strict";
-/**
- * ObjectQL
- * Copyright (c) 2026-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SQLQueryOptimizer = exports.DependencyGraph = exports.LazyMetadataLoader = exports.OptimizedValidationEngine = exports.GlobalConnectionPool = exports.CompiledHookManager = exports.QueryCompiler = exports.OptimizedMetadataRegistry = void 0;
-/**
- * Kernel Optimizations Module
- *
- * This module contains 10 key optimizations for the ObjectQL kernel:
- *
- * 1. OptimizedMetadataRegistry - O(k) package uninstall with secondary indexes
- * 2. QueryCompiler - LRU cache for compiled query plans
- * 3. CompiledHookManager - Pre-compiled hook pipelines
- * 4. GlobalConnectionPool - Kernel-level connection pooling
- * 5. OptimizedValidationEngine - Compiled validation rules
- * 6. LazyMetadataLoader - On-demand metadata loading with predictive preload
- * 7. DependencyGraph - DAG-based dependency resolution
- * 8. SQLQueryOptimizer - SQL-aware query optimization with index hints
- *
- * Note: TypeScript type generation optimization (#7) and memory-mapped storage (#10)
- * are not included in this release for compatibility and complexity reasons.
- */
-var OptimizedMetadataRegistry_1 = require("./OptimizedMetadataRegistry");
-Object.defineProperty(exports, "OptimizedMetadataRegistry", { enumerable: true, get: function () { return OptimizedMetadataRegistry_1.OptimizedMetadataRegistry; } });
-var QueryCompiler_1 = require("./QueryCompiler");
-Object.defineProperty(exports, "QueryCompiler", { enumerable: true, get: function () { return QueryCompiler_1.QueryCompiler; } });
-var CompiledHookManager_1 = require("./CompiledHookManager");
-Object.defineProperty(exports, "CompiledHookManager", { enumerable: true, get: function () { return CompiledHookManager_1.CompiledHookManager; } });
-var GlobalConnectionPool_1 = require("./GlobalConnectionPool");
-Object.defineProperty(exports, "GlobalConnectionPool", { enumerable: true, get: function () { return GlobalConnectionPool_1.GlobalConnectionPool; } });
-var OptimizedValidationEngine_1 = require("./OptimizedValidationEngine");
-Object.defineProperty(exports, "OptimizedValidationEngine", { enumerable: true, get: function () { return OptimizedValidationEngine_1.OptimizedValidationEngine; } });
-var LazyMetadataLoader_1 = require("./LazyMetadataLoader");
-Object.defineProperty(exports, "LazyMetadataLoader", { enumerable: true, get: function () { return LazyMetadataLoader_1.LazyMetadataLoader; } });
-var DependencyGraph_1 = require("./DependencyGraph");
-Object.defineProperty(exports, "DependencyGraph", { enumerable: true, get: function () { return DependencyGraph_1.DependencyGraph; } });
-var SQLQueryOptimizer_1 = require("./SQLQueryOptimizer");
-Object.defineProperty(exports, "SQLQueryOptimizer", { enumerable: true, get: function () { return SQLQueryOptimizer_1.SQLQueryOptimizer; } });
-//# sourceMappingURL=index.js.map

package/dist/optimizations/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/optimizations/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH,yEAAwE;AAA/D,sIAAA,yBAAyB,OAAA;AAClC,iDAAoE;AAA3D,8GAAA,aAAa,OAAA;AACtB,6DAAuE;AAA9D,0HAAA,mBAAmB,OAAA;AAC5B,+DAAgG;AAAvF,4HAAA,oBAAoB,OAAA;AAC7B,yEAAuH;AAA9G,sIAAA,yBAAyB,OAAA;AAClC,2DAAoG;AAA3F,wHAAA,kBAAkB,OAAA;AAC3B,qDAA8F;AAArF,kHAAA,eAAe,OAAA;AACxB,yDAA8H;AAArH,sHAAA,iBAAiB,OAAA"}

package/dist/protocol.d.ts

@@ -1,191 +0,0 @@
-/**
- * ObjectStack Protocol Implementation
- * Copyright (c) 2026-present ObjectStack Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-import { ObjectStackProtocol } from '@objectstack/spec/api';
-import { IObjectQL } from '@objectql/types';
-/**
- * Bridges the ObjectStack Protocol (Specification) to the ObjectQL Engine (Implementation)
- */
-export declare class ObjectStackProtocolImplementation implements ObjectStackProtocol {
-    private engine;
-    constructor(engine: IObjectQL);
-    /**
-     * Get API Discovery Document
-     */
-    getDiscovery(args: any): Promise<any>;
-    /**
-     * Get Metadata Types (e.g., ['object', 'action'])
-     */
-    getMetaTypes(args: any): Promise<{
-        types: string[];
-    }>;
-    /**
-     * Get Metadata Items for a Type
-     */
-    getMetaItems(args: {
-        type: string;
-    }): Promise<{
-        type: string;
-        items: any[];
-    }>;
-    /**
-     * Get Metadata Item
-     */
-    getMetaItem(args: {
-        type: string;
-        name: string;
-    }): Promise<any>;
-    /**
-     * Get Cached Metadata Item
-     */
-    getMetaItemCached(args: {
-        type: string;
-        name: string;
-    }): Promise<any>;
-    /**
-     * Save Metadata Item
-     */
-    saveMetaItem(args: {
-        type: string;
-        name: string;
-        item?: any;
-    }): Promise<{
-        success: boolean;
-        message?: string;
-    }>;
-    /**
-     * Get UI View
-     */
-    getUiView(args: {
-        object: string;
-        type: 'list' | 'form';
-    }): Promise<any>;
-    /**
-     * Find Data Records
-     */
-    findData(args: {
-        object: string;
-        query?: any;
-    }): Promise<any>;
-    /**
-     * Count Data Records
-     */
-    countData(args: {
-        object: string;
-        query?: any;
-    }): Promise<number>;
-    /**
-     * Get Single Data Record
-     */
-    getData(args: {
-        object: string;
-        id: string;
-    }): Promise<any>;
-    /**
-     * Create Data Record
-     */
-    createData(args: {
-        object: string;
-        data: any;
-    }): Promise<any>;
-    /**
-     * Update Data Record
-     */
-    updateData(args: {
-        object: string;
-        id: string;
-        data: any;
-    }): Promise<any>;
-    /**
-     * Delete Data Record
-     */
-    deleteData(args: {
-        object: string;
-        id: string;
-    }): Promise<{
-        object: string;
-        id: string;
-        success: boolean;
-    }>;
-    /**
-     * Create Many Data Records
-     */
-    createManyData(args: {
-        object: string;
-        records: any[];
-        options?: any;
-    }): Promise<any>;
-    /**
-     * Update Many Data Records
-     */
-    updateManyData(args: {
-        object: string;
-        records: {
-            id: string;
-            data: any;
-        }[];
-        options?: any;
-    }): Promise<any>;
-    /**
-     * Delete Many Data Records
-     */
-    deleteManyData(args: {
-        object: string;
-        ids: string[];
-        options?: any;
-    }): Promise<any>;
-    /**
-     * Batch Operations
-     */
-    batchData(args: {
-        object: string;
-        request: {
-            operation: 'create' | 'update' | 'delete' | 'upsert';
-            records: any[];
-        };
-    }): Promise<any>;
-    /**
-     * Execute Action/Operation
-     */
-    performAction(args: {
-        object: string;
-        id?: string;
-        action: string;
-        args?: any;
-    }): Promise<any>;
-    /**
-     * Analytics Query - Execute analytics query
-     */
-    analyticsQuery(args: any): Promise<any>;
-    /**
-     * Get Analytics Metadata
-     */
-    getAnalyticsMeta(args: any): Promise<any>;
-    /**
-     * Trigger Automation
-     */
-    triggerAutomation(args: {
-        trigger: string;
-        payload: Record<string, any>;
-    }): Promise<{
-        success: boolean;
-        jobId?: string;
-        result?: any;
-    }>;
-    /**
-     * List Spaces (Hub/Workspace Management)
-     */
-    listSpaces(args: any): Promise<any>;
-    /**
-     * Create Space (Hub/Workspace Management)
-     */
-    createSpace(args: any): Promise<any>;
-    /**
-     * Install Plugin (Hub/Extension Management)
-     */
-    installPlugin(args: any): Promise<any>;
-}