@rws-framework/db 3.9.0 → 3.9.1

package/dist/models/utils/LoadingContext.js

@@ -1,119 +0,0 @@
-"use strict";
-/**
- * LoadingContext - Prevents circular references during model loading by tracking
- * the chain of models currently being loaded per execution context
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LoadingContext = void 0;
-class LoadingContext {
-    static executionContexts = new WeakMap();
-    static defaultMaxDepth = 10;
-    /**
-     * Get or create execution context identifier
-     */
-    static getExecutionContext() {
-        // Use a simple object as execution context identifier
-        // In a real-world scenario, this could be tied to request context
-        if (!globalThis.__currentExecutionContext) {
-            globalThis.__currentExecutionContext = {};
-        }
-        return globalThis.__currentExecutionContext;
-    }
-    /**
-     * Create a new execution context for an operation
-     */
-    static withNewExecutionContext(fn) {
-        const previousContext = globalThis.__currentExecutionContext;
-        try {
-            globalThis.__currentExecutionContext = {};
-            return fn();
-        }
-        finally {
-            globalThis.__currentExecutionContext = previousContext;
-        }
-    }
-    /**
-     * Get the loading stack for current execution context
-     */
-    static getLoadingStackInternal() {
-        const context = this.getExecutionContext();
-        if (!this.executionContexts.has(context)) {
-            this.executionContexts.set(context, new Set());
-        }
-        return this.executionContexts.get(context);
-    }
-    /**
-     * Check if a model with specific ID is currently being loaded
-     */
-    static isLoading(modelType, id) {
-        const key = this.createKey(modelType, id);
-        const loadingStack = this.getLoadingStackInternal();
-        return loadingStack.has(key);
-    }
-    /**
-     * Mark a model as currently being loaded
-     */
-    static startLoading(modelType, id) {
-        const key = this.createKey(modelType, id);
-        const loadingStack = this.getLoadingStackInternal();
-        // Check for maximum depth to prevent infinite chains
-        if (loadingStack.size >= this.defaultMaxDepth) {
-            const stackArray = Array.from(loadingStack);
-            throw new Error(`Maximum loading depth (${this.defaultMaxDepth}) exceeded. ` +
-                `Possible circular reference detected. Loading stack: ${stackArray.join(' -> ')} -> ${key}`);
-        }
-        loadingStack.add(key);
-    }
-    /**
-     * Mark a model as finished loading
-     */
-    static finishLoading(modelType, id) {
-        const key = this.createKey(modelType, id);
-        const loadingStack = this.getLoadingStackInternal();
-        loadingStack.delete(key);
-    }
-    /**
-     * Get current loading stack for debugging
-     */
-    static getLoadingStack() {
-        const loadingStack = this.getLoadingStackInternal();
-        return Array.from(loadingStack);
-    }
-    /**
-     * Clear the entire loading stack for current context
-     */
-    static clearStack() {
-        const loadingStack = this.getLoadingStackInternal();
-        loadingStack.clear();
-    }
-    /**
-     * Set default maximum loading depth
-     */
-    static setDefaultMaxDepth(depth) {
-        this.defaultMaxDepth = depth;
-    }
-    /**
-     * Create a unique key for model type and ID
-     */
-    static createKey(modelType, id) {
-        return `${modelType}:${id}`;
-    }
-    /**
-     * Execute a function with loading context protection
-     * Automatically manages start/finish loading calls
-     */
-    static async withLoadingContext(modelType, id, fn) {
-        if (this.isLoading(modelType, id)) {
-            // If already loading, return null to break the cycle
-            return null;
-        }
-        this.startLoading(modelType, id);
-        try {
-            return await fn();
-        }
-        finally {
-            this.finishLoading(modelType, id);
-        }
-    }
-}
-exports.LoadingContext = LoadingContext;

package/dist/models/utils/LoadingContext.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Simple test to verify LoadingContext functionality
- */
-declare function testLoadingContext(): Promise<void>;
-export { testLoadingContext };

package/dist/models/utils/LoadingContext.test.js

@@ -1,51 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.testLoadingContext = testLoadingContext;
-const LoadingContext_1 = require("./LoadingContext");
-/**
- * Simple test to verify LoadingContext functionality
- */
-async function testLoadingContext() {
-    console.log('Testing LoadingContext...');
-    // Test 1: Basic loading detection
-    console.log('Test 1: Basic loading detection');
-    console.log('Is User:1 loading?', LoadingContext_1.LoadingContext.isLoading('User', 1)); // Should be false
-    LoadingContext_1.LoadingContext.startLoading('User', 1);
-    console.log('Is User:1 loading?', LoadingContext_1.LoadingContext.isLoading('User', 1)); // Should be true
-    LoadingContext_1.LoadingContext.finishLoading('User', 1);
-    console.log('Is User:1 loading?', LoadingContext_1.LoadingContext.isLoading('User', 1)); // Should be false
-    // Test 2: Circular reference detection
-    console.log('\nTest 2: Circular reference detection');
-    try {
-        await LoadingContext_1.LoadingContext.withLoadingContext('User', 1, async () => {
-            console.log('Loading User:1...');
-            // Simulate trying to load the same model again (circular reference)
-            const result = await LoadingContext_1.LoadingContext.withLoadingContext('User', 1, async () => {
-                console.log('This should not execute - circular reference detected');
-                return 'should not reach here';
-            });
-            console.log('Circular reference result:', result); // Should be null
-            return 'User loaded successfully';
-        });
-    }
-    catch (error) {
-        console.error('Error in circular reference test:', error);
-    }
-    // Test 3: Maximum depth protection
-    console.log('\nTest 3: Maximum depth protection');
-    LoadingContext_1.LoadingContext.setMaxDepth(3);
-    try {
-        LoadingContext_1.LoadingContext.startLoading('Model1', 1);
-        LoadingContext_1.LoadingContext.startLoading('Model2', 2);
-        LoadingContext_1.LoadingContext.startLoading('Model3', 3);
-        // This should throw an error
-        LoadingContext_1.LoadingContext.startLoading('Model4', 4);
-    }
-    catch (error) {
-        console.log('Expected error caught:', error.message);
-    }
-    finally {
-        LoadingContext_1.LoadingContext.clearStack();
-    }
-    console.log('LoadingContext tests completed!');
-}

package/dist/models/utils/index.d.ts

@@ -1,7 +0,0 @@
-export { FindUtils } from './FindUtils';
-export { HydrateUtils } from './HydrateUtils';
-export { LoadingContext } from './LoadingContext';
-export { ModelUtils } from './ModelUtils';
-export { PaginationUtils } from './PaginationUtils';
-export { RelationUtils } from './RelationUtils';
-export { TimeSeriesUtils } from './TimeSeriesUtils';

package/dist/models/utils/index.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeSeriesUtils = exports.RelationUtils = exports.PaginationUtils = exports.ModelUtils = exports.LoadingContext = exports.HydrateUtils = exports.FindUtils = void 0;
-var FindUtils_1 = require("./FindUtils");
-Object.defineProperty(exports, "FindUtils", { enumerable: true, get: function () { return FindUtils_1.FindUtils; } });
-var HydrateUtils_1 = require("./HydrateUtils");
-Object.defineProperty(exports, "HydrateUtils", { enumerable: true, get: function () { return HydrateUtils_1.HydrateUtils; } });
-var LoadingContext_1 = require("./LoadingContext");
-Object.defineProperty(exports, "LoadingContext", { enumerable: true, get: function () { return LoadingContext_1.LoadingContext; } });
-var ModelUtils_1 = require("./ModelUtils");
-Object.defineProperty(exports, "ModelUtils", { enumerable: true, get: function () { return ModelUtils_1.ModelUtils; } });
-var PaginationUtils_1 = require("./PaginationUtils");
-Object.defineProperty(exports, "PaginationUtils", { enumerable: true, get: function () { return PaginationUtils_1.PaginationUtils; } });
-var RelationUtils_1 = require("./RelationUtils");
-Object.defineProperty(exports, "RelationUtils", { enumerable: true, get: function () { return RelationUtils_1.RelationUtils; } });
-var TimeSeriesUtils_1 = require("./TimeSeriesUtils");
-Object.defineProperty(exports, "TimeSeriesUtils", { enumerable: true, get: function () { return TimeSeriesUtils_1.TimeSeriesUtils; } });

package/src/models/utils/LoadingContext.ts

@@ -1,140 +0,0 @@
-/**
- * LoadingContext - Prevents circular references during model loading by tracking
- * the chain of models currently being loaded per execution context
- */
-
-// Extend the global object type to include our execution context
-declare global {
-    var __currentExecutionContext: object | undefined;
-}
-
-export class LoadingContext {
-    private static executionContexts = new WeakMap<object, Set<string>>();
-    private static defaultMaxDepth: number = 10;
-
-    /**
-     * Get or create execution context identifier
-     */
-    private static getExecutionContext(): object {
-        // Use a simple object as execution context identifier
-        // In a real-world scenario, this could be tied to request context
-        if (!globalThis.__currentExecutionContext) {
-            globalThis.__currentExecutionContext = {};
-        }
-        return globalThis.__currentExecutionContext;
-    }
-
-    /**
-     * Create a new execution context for an operation
-     */
-    static withNewExecutionContext<T>(fn: () => Promise<T>): Promise<T> {
-        const previousContext = globalThis.__currentExecutionContext;
-        
-        try {
-            globalThis.__currentExecutionContext = {};
-            return fn();
-        } finally {
-            globalThis.__currentExecutionContext = previousContext;
-        }
-    }
-
-    /**
-     * Get the loading stack for current execution context
-     */
-    private static getLoadingStackInternal(): Set<string> {
-        const context = this.getExecutionContext();
-        if (!this.executionContexts.has(context)) {
-            this.executionContexts.set(context, new Set<string>());
-        }
-        return this.executionContexts.get(context)!;
-    }
-
-    /**
-     * Check if a model with specific ID is currently being loaded
-     */
-    static isLoading(modelType: string, id: string | number): boolean {
-        const key = this.createKey(modelType, id);
-        const loadingStack = this.getLoadingStackInternal();
-        return loadingStack.has(key);
-    }
-
-    /**
-     * Mark a model as currently being loaded
-     */
-    static startLoading(modelType: string, id: string | number): void {
-        const key = this.createKey(modelType, id);
-        const loadingStack = this.getLoadingStackInternal();
-        
-        // Check for maximum depth to prevent infinite chains
-        if (loadingStack.size >= this.defaultMaxDepth) {
-            const stackArray = Array.from(loadingStack);
-            throw new Error(
-                `Maximum loading depth (${this.defaultMaxDepth}) exceeded. ` +
-                `Possible circular reference detected. Loading stack: ${stackArray.join(' -> ')} -> ${key}`
-            );
-        }
-        
-        loadingStack.add(key);
-    }
-
-    /**
-     * Mark a model as finished loading
-     */
-    static finishLoading(modelType: string, id: string | number): void {
-        const key = this.createKey(modelType, id);
-        const loadingStack = this.getLoadingStackInternal();
-        loadingStack.delete(key);
-    }
-
-    /**
-     * Get current loading stack for debugging
-     */
-    static getLoadingStack(): string[] {
-        const loadingStack = this.getLoadingStackInternal();
-        return Array.from(loadingStack);
-    }
-
-    /**
-     * Clear the entire loading stack for current context
-     */
-    static clearStack(): void {
-        const loadingStack = this.getLoadingStackInternal();
-        loadingStack.clear();
-    }
-
-    /**
-     * Set default maximum loading depth
-     */
-    static setDefaultMaxDepth(depth: number): void {
-        this.defaultMaxDepth = depth;
-    }
-
-    /**
-     * Create a unique key for model type and ID
-     */
-    private static createKey(modelType: string, id: string | number): string {
-        return `${modelType}:${id}`;
-    }
-
-    /**
-     * Execute a function with loading context protection
-     * Automatically manages start/finish loading calls
-     */
-    static async withLoadingContext<T>(
-        modelType: string, 
-        id: string | number, 
-        fn: () => Promise<T>
-    ): Promise<T> {
-        if (this.isLoading(modelType, id)) {
-            // If already loading, return null to break the cycle
-            return null as T;
-        }
-
-        this.startLoading(modelType, id);
-        try {
-            return await fn();
-        } finally {
-            this.finishLoading(modelType, id);
-        }
-    }
-}

package/src/models/utils/index.ts

@@ -1,7 +0,0 @@
-export { FindUtils } from './FindUtils';
-export { HydrateUtils } from './HydrateUtils';
-export { LoadingContext } from './LoadingContext';
-export { ModelUtils } from './ModelUtils';
-export { PaginationUtils } from './PaginationUtils';
-export { RelationUtils } from './RelationUtils';
-export { TimeSeriesUtils } from './TimeSeriesUtils';