@objectql/core 4.2.0 → 4.2.2

package/dist/optimizations/GlobalConnectionPool.d.ts

@@ -1,89 +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.
- */
-/**
- * Connection interface
- */
-export interface Connection {
-    id: string;
-    driverName: string;
-    inUse: boolean;
-    createdAt: number;
-    lastUsedAt: number;
-    release: () => Promise<void>;
-}
-/**
- * Connection pool limits
- */
-export interface PoolLimits {
-    total: number;
-    perDriver: number;
-}
-/**
- * Global Connection Pool Manager
- *
- * Improvement: Kernel-level connection pool with global limits.
- * Coordinates connection allocation across all drivers.
- *
- * Expected: 5x faster connection acquisition, predictable resource usage
- */
-export declare class GlobalConnectionPool {
-    private limits;
-    private allocations;
-    private connections;
-    private waitQueue;
-    constructor(limits?: PoolLimits);
-    /**
-     * Get total number of active connections across all drivers
-     */
-    private totalConnections;
-    /**
-     * Get number of connections for a specific driver
-     */
-    private getDriverConnections;
-    /**
-     * Try to process the wait queue
-     */
-    private processWaitQueue;
-    /**
-     * Check if we can allocate a connection for a driver
-     */
-    private canAllocate;
-    /**
-     * Actually acquire a connection (internal)
-     */
-    private doAcquire;
-    /**
-     * Acquire a connection from the pool
-     */
-    acquire(driverName: string): Promise<Connection>;
-    /**
-     * Release a connection back to the pool
-     */
-    release(connection: Connection): Promise<void>;
-    /**
-     * Close all connections for a driver
-     */
-    closeDriver(driverName: string): Promise<void>;
-    /**
-     * Get pool statistics
-     */
-    getStats(): {
-        totalConnections: number;
-        totalLimit: number;
-        perDriverLimit: number;
-        driverStats: Record<string, {
-            active: number;
-            idle: number;
-        }>;
-        waitQueueSize: number;
-    };
-    /**
-     * Update pool limits
-     */
-    updateLimits(limits: Partial<PoolLimits>): void;
-}

package/dist/optimizations/GlobalConnectionPool.js

@@ -1,193 +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.GlobalConnectionPool = void 0;
-/**
- * Global Connection Pool Manager
- *
- * Improvement: Kernel-level connection pool with global limits.
- * Coordinates connection allocation across all drivers.
- *
- * Expected: 5x faster connection acquisition, predictable resource usage
- */
-class GlobalConnectionPool {
-    constructor(limits = { total: 50, perDriver: 20 }) {
-        this.allocations = new Map();
-        this.connections = new Map();
-        this.waitQueue = [];
-        this.limits = limits;
-    }
-    /**
-     * Get total number of active connections across all drivers
-     */
-    totalConnections() {
-        let total = 0;
-        for (const count of this.allocations.values()) {
-            total += count;
-        }
-        return total;
-    }
-    /**
-     * Get number of connections for a specific driver
-     */
-    getDriverConnections(driverName) {
-        return this.allocations.get(driverName) || 0;
-    }
-    /**
-     * Try to process the wait queue
-     */
-    processWaitQueue() {
-        if (this.waitQueue.length === 0)
-            return;
-        // Check if we can fulfill any waiting requests
-        for (let i = 0; i < this.waitQueue.length; i++) {
-            const request = this.waitQueue[i];
-            // Check if we can allocate
-            if (this.canAllocate(request.driverName)) {
-                this.waitQueue.splice(i, 1);
-                // Try to acquire connection
-                this.doAcquire(request.driverName)
-                    .then(request.resolve)
-                    .catch(request.reject);
-                // Only process one at a time to avoid over-allocation
-                break;
-            }
-        }
-    }
-    /**
-     * Check if we can allocate a connection for a driver
-     */
-    canAllocate(driverName) {
-        const totalConns = this.totalConnections();
-        const driverConns = this.getDriverConnections(driverName);
-        // Check if there's an idle connection available
-        const driverConnections = this.connections.get(driverName) || [];
-        const hasIdleConnection = driverConnections.some(c => !c.inUse);
-        // Can allocate if:
-        // 1. There's an idle connection (reuse), OR
-        // 2. We're under the total and per-driver limits (create new)
-        return hasIdleConnection || (totalConns < this.limits.total && driverConns < this.limits.perDriver);
-    }
-    /**
-     * Actually acquire a connection (internal)
-     */
-    async doAcquire(driverName) {
-        // Check for available idle connection first
-        const driverConnections = this.connections.get(driverName) || [];
-        const idleConnection = driverConnections.find(c => !c.inUse);
-        if (idleConnection) {
-            idleConnection.inUse = true;
-            idleConnection.lastUsedAt = Date.now();
-            return idleConnection;
-        }
-        // Verify we can create a new connection (double-check to prevent race conditions)
-        const totalConns = this.totalConnections();
-        const driverConns = this.getDriverConnections(driverName);
-        if (totalConns >= this.limits.total || driverConns >= this.limits.perDriver) {
-            throw new Error(`Connection pool limit reached for driver: ${driverName}`);
-        }
-        // Create new connection
-        const connectionId = `${driverName}-${Date.now()}-${Math.random()}`;
-        const connection = {
-            id: connectionId,
-            driverName,
-            inUse: true,
-            createdAt: Date.now(),
-            lastUsedAt: Date.now(),
-            release: async () => {
-                connection.inUse = false;
-                connection.lastUsedAt = Date.now();
-                // Process wait queue when connection is released
-                this.processWaitQueue();
-            }
-        };
-        // Store connection
-        if (!this.connections.has(driverName)) {
-            this.connections.set(driverName, []);
-        }
-        this.connections.get(driverName).push(connection);
-        // Update allocation count
-        this.allocations.set(driverName, this.getDriverConnections(driverName) + 1);
-        return connection;
-    }
-    /**
-     * Acquire a connection from the pool
-     */
-    async acquire(driverName) {
-        // Check global limits before allocation ✅
-        if (!this.canAllocate(driverName)) {
-            // Add to wait queue
-            return new Promise((resolve, reject) => {
-                this.waitQueue.push({ driverName, resolve, reject });
-                // Set timeout to prevent indefinite waiting
-                setTimeout(() => {
-                    const index = this.waitQueue.findIndex(r => r.driverName === driverName && r.resolve === resolve);
-                    if (index >= 0) {
-                        this.waitQueue.splice(index, 1);
-                        reject(new Error(`Connection pool limit reached for driver: ${driverName}`));
-                    }
-                }, 30000); // 30 second timeout
-            });
-        }
-        return this.doAcquire(driverName);
-    }
-    /**
-     * Release a connection back to the pool
-     */
-    async release(connection) {
-        await connection.release();
-    }
-    /**
-     * Close all connections for a driver
-     */
-    async closeDriver(driverName) {
-        const driverConnections = this.connections.get(driverName);
-        if (driverConnections) {
-            // Clear all connections
-            driverConnections.length = 0;
-            this.connections.delete(driverName);
-            this.allocations.delete(driverName);
-        }
-        // Process wait queue
-        this.processWaitQueue();
-    }
-    /**
-     * Get pool statistics
-     */
-    getStats() {
-        const driverStats = {};
-        for (const [driverName, connections] of this.connections.entries()) {
-            const active = connections.filter(c => c.inUse).length;
-            const idle = connections.filter(c => !c.inUse).length;
-            driverStats[driverName] = { active, idle };
-        }
-        return {
-            totalConnections: this.totalConnections(),
-            totalLimit: this.limits.total,
-            perDriverLimit: this.limits.perDriver,
-            driverStats,
-            waitQueueSize: this.waitQueue.length
-        };
-    }
-    /**
-     * Update pool limits
-     */
-    updateLimits(limits) {
-        if (limits.total !== undefined) {
-            this.limits.total = limits.total;
-        }
-        if (limits.perDriver !== undefined) {
-            this.limits.perDriver = limits.perDriver;
-        }
-        // Process wait queue after limits update
-        this.processWaitQueue();
-    }
-}
-exports.GlobalConnectionPool = GlobalConnectionPool;
-//# sourceMappingURL=GlobalConnectionPool.js.map

package/dist/optimizations/GlobalConnectionPool.js.map

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

package/dist/optimizations/LazyMetadataLoader.d.ts

@@ -1,75 +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.
- */
-/**
- * Object metadata definition
- */
-export interface ObjectMetadata {
-    name: string;
-    label?: string;
-    fields: Record<string, any>;
-    triggers?: any[];
-    workflows?: any[];
-    permissions?: any[];
-    relatedObjects?: string[];
-}
-/**
- * Metadata loader function type
- */
-export type MetadataLoader = (objectName: string) => Promise<ObjectMetadata>;
-/**
- * Lazy Metadata Loader with Smart Caching
- *
- * Improvement: Loads metadata on-demand instead of eagerly at startup.
- * Includes predictive preloading for related objects.
- *
- * Expected: 10x faster startup, 70% lower initial memory
- */
-export declare class LazyMetadataLoader {
-    private cache;
-    private loaded;
-    private loading;
-    private preloadScheduled;
-    private loader;
-    constructor(loader: MetadataLoader);
-    /**
-     * Load a single object's metadata
-     */
-    private loadSingle;
-    /**
-     * Predictive preload: load related objects in the background
-     */
-    private predictivePreload;
-    /**
-     * Get metadata for an object (loads on-demand if not cached)
-     */
-    get(objectName: string): Promise<ObjectMetadata>;
-    /**
-     * Check if metadata is loaded
-     */
-    isLoaded(objectName: string): boolean;
-    /**
-     * Preload metadata for specific objects
-     */
-    preload(objectNames: string[]): Promise<void>;
-    /**
-     * Clear cache for an object
-     */
-    invalidate(objectName: string): void;
-    /**
-     * Clear all cached metadata
-     */
-    clearAll(): void;
-    /**
-     * Get statistics about loaded metadata
-     */
-    getStats(): {
-        loaded: number;
-        cached: number;
-        loading: number;
-    };
-}

package/dist/optimizations/LazyMetadataLoader.js

@@ -1,149 +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.LazyMetadataLoader = void 0;
-/**
- * Lazy Metadata Loader with Smart Caching
- *
- * Improvement: Loads metadata on-demand instead of eagerly at startup.
- * Includes predictive preloading for related objects.
- *
- * Expected: 10x faster startup, 70% lower initial memory
- */
-class LazyMetadataLoader {
-    constructor(loader) {
-        this.cache = new Map();
-        this.loaded = new Set();
-        this.loading = new Map();
-        this.preloadScheduled = new Set(); // Track objects with scheduled preloads
-        this.loader = loader;
-    }
-    /**
-     * Load a single object's metadata
-     */
-    async loadSingle(objectName) {
-        // Check if already loaded
-        if (this.loaded.has(objectName)) {
-            const cached = this.cache.get(objectName);
-            if (cached)
-                return cached;
-        }
-        // Check if currently loading (avoid duplicate loads)
-        const existingLoad = this.loading.get(objectName);
-        if (existingLoad) {
-            return existingLoad;
-        }
-        // Load metadata
-        const loadPromise = (async () => {
-            try {
-                const metadata = await this.loader(objectName);
-                this.cache.set(objectName, metadata);
-                this.loaded.add(objectName);
-                return metadata;
-            }
-            finally {
-                this.loading.delete(objectName);
-            }
-        })();
-        this.loading.set(objectName, loadPromise);
-        return loadPromise;
-    }
-    /**
-     * Predictive preload: load related objects in the background
-     */
-    predictivePreload(objectName) {
-        // Avoid redundant preload scheduling for the same object
-        if (this.preloadScheduled.has(objectName)) {
-            return;
-        }
-        this.preloadScheduled.add(objectName);
-        // Run preloading asynchronously after current call stack to avoid blocking
-        setImmediate(() => {
-            const metadata = this.cache.get(objectName);
-            if (!metadata)
-                return;
-            // Extract related object names from various sources
-            const relatedObjects = new Set();
-            // 1. From explicit relatedObjects field
-            if (metadata.relatedObjects) {
-                metadata.relatedObjects.forEach(obj => relatedObjects.add(obj));
-            }
-            // 2. From lookup/master-detail fields
-            if (metadata.fields) {
-                for (const field of Object.values(metadata.fields)) {
-                    if (field.type === 'lookup' || field.type === 'master_detail') {
-                        if (field.reference_to) {
-                            relatedObjects.add(field.reference_to);
-                        }
-                    }
-                }
-            }
-            // Preload related objects asynchronously (don't await)
-            for (const relatedObject of relatedObjects) {
-                if (!this.loaded.has(relatedObject) && !this.loading.has(relatedObject)) {
-                    // Fire and forget - preload in background
-                    this.loadSingle(relatedObject).catch(() => {
-                        // Ignore errors in background preloading
-                    });
-                }
-            }
-        });
-    }
-    /**
-     * Get metadata for an object (loads on-demand if not cached)
-     */
-    async get(objectName) {
-        // Load on first access
-        const metadata = await this.loadSingle(objectName);
-        // Trigger predictive preloading for related objects
-        this.predictivePreload(objectName);
-        return metadata;
-    }
-    /**
-     * Check if metadata is loaded
-     */
-    isLoaded(objectName) {
-        return this.loaded.has(objectName);
-    }
-    /**
-     * Preload metadata for specific objects
-     */
-    async preload(objectNames) {
-        await Promise.all(objectNames.map(name => this.get(name)));
-    }
-    /**
-     * Clear cache for an object
-     */
-    invalidate(objectName) {
-        this.cache.delete(objectName);
-        this.loaded.delete(objectName);
-        this.preloadScheduled.delete(objectName);
-    }
-    /**
-     * Clear all cached metadata
-     */
-    clearAll() {
-        this.cache.clear();
-        this.loaded.clear();
-        this.loading.clear();
-        this.preloadScheduled.clear();
-    }
-    /**
-     * Get statistics about loaded metadata
-     */
-    getStats() {
-        return {
-            loaded: this.loaded.size,
-            cached: this.cache.size,
-            loading: this.loading.size
-        };
-    }
-}
-exports.LazyMetadataLoader = LazyMetadataLoader;
-//# sourceMappingURL=LazyMetadataLoader.js.map

package/dist/optimizations/LazyMetadataLoader.js.map

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

package/dist/optimizations/OptimizedMetadataRegistry.d.ts

@@ -1,26 +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.
- */
-export declare class OptimizedMetadataRegistry {
-    private items;
-    private packageIndex;
-    constructor();
-    register(type: string, nameOrConfig: any, config?: any): void;
-    get<T = any>(type: string, name: string): T;
-    list<T = any>(type: string): T[];
-    getTypes(): string[];
-    getEntry<T = any>(type: string, name: string): T;
-    unregister(type: string, name: string): void;
-    /**
-     * Optimized package unregistration with O(k) complexity
-     * where k is the number of items in the package.
-     *
-     * Previous complexity: O(n*m) - iterate all types and all items
-     * New complexity: O(k) - direct lookup via secondary index
-     */
-    unregisterPackage(packageName: string): void;
-}

package/dist/optimizations/OptimizedMetadataRegistry.js

@@ -1,117 +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.OptimizedMetadataRegistry = void 0;
-class OptimizedMetadataRegistry {
-    constructor() {
-        this.items = {};
-        // Secondary index: package name -> list of metadata references
-        this.packageIndex = new Map();
-    }
-    register(type, nameOrConfig, config) {
-        if (!this.items[type]) {
-            this.items[type] = {};
-        }
-        let name;
-        let item;
-        if (config) {
-            name = nameOrConfig;
-            item = config;
-        }
-        else {
-            item = nameOrConfig;
-            name = item.name || item.id;
-        }
-        if (name) {
-            this.items[type][name] = item;
-            // Update package index
-            const packageName = item.package || item._package || item.packageName;
-            if (packageName) {
-                if (!this.packageIndex.has(packageName)) {
-                    this.packageIndex.set(packageName, new Set());
-                }
-                this.packageIndex.get(packageName).add({ type, name });
-            }
-        }
-    }
-    get(type, name) {
-        var _a;
-        const item = (_a = this.items[type]) === null || _a === void 0 ? void 0 : _a[name];
-        if (item && item.content) {
-            return item.content;
-        }
-        return item;
-    }
-    list(type) {
-        if (!this.items[type])
-            return [];
-        return Object.values(this.items[type]).map((item) => {
-            if (item && item.content) {
-                return item.content;
-            }
-            return item;
-        });
-    }
-    getTypes() {
-        return Object.keys(this.items);
-    }
-    getEntry(type, name) {
-        var _a;
-        return (_a = this.items[type]) === null || _a === void 0 ? void 0 : _a[name];
-    }
-    unregister(type, name) {
-        var _a;
-        const item = (_a = this.items[type]) === null || _a === void 0 ? void 0 : _a[name];
-        if (item) {
-            // Update package index
-            const packageName = item.package || item._package || item.packageName;
-            if (packageName) {
-                const refs = this.packageIndex.get(packageName);
-                if (refs) {
-                    // Remove this specific reference
-                    for (const ref of refs) {
-                        if (ref.type === type && ref.name === name) {
-                            refs.delete(ref);
-                            break;
-                        }
-                    }
-                    // Clean up empty package entries
-                    if (refs.size === 0) {
-                        this.packageIndex.delete(packageName);
-                    }
-                }
-            }
-            delete this.items[type][name];
-        }
-    }
-    /**
-     * Optimized package unregistration with O(k) complexity
-     * where k is the number of items in the package.
-     *
-     * Previous complexity: O(n*m) - iterate all types and all items
-     * New complexity: O(k) - direct lookup via secondary index
-     */
-    unregisterPackage(packageName) {
-        var _a;
-        // Direct lookup via secondary index ✅
-        const refs = this.packageIndex.get(packageName);
-        if (refs) {
-            // Delete each item referenced by this package
-            for (const ref of refs) {
-                if ((_a = this.items[ref.type]) === null || _a === void 0 ? void 0 : _a[ref.name]) {
-                    delete this.items[ref.type][ref.name];
-                }
-            }
-            // Remove package from index
-            this.packageIndex.delete(packageName);
-        }
-    }
-}
-exports.OptimizedMetadataRegistry = OptimizedMetadataRegistry;
-//# sourceMappingURL=OptimizedMetadataRegistry.js.map

package/dist/optimizations/OptimizedMetadataRegistry.js.map

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