@warlock.js/cascade 4.0.174 → 4.1.2

package/esm/sync/sync-manager.js

@@ -1,689 +0,0 @@
-import {Model}from'../model/model.js';import {DEFAULT_MAX_SYNC_DEPTH,SyncContextManager}from'./sync-context.js';/**
- * Sync manager service for handling multi-level sync operations.
- *
- * @module cascade-next/sync/sync-manager
- */
-/**
- * Manages sync operations across models with multi-level support.
- */
-class SyncManager {
-    sourceModel;
-    driver;
-    /**
-     * Creates a new sync manager.
-     *
-     * @param sourceModel - The source model class
-     * @param driver - The database driver
-     */
-    constructor(sourceModel, driver) {
-        this.sourceModel = sourceModel;
-        this.driver = driver;
-    }
-    /**
-     * Executes sync operations for a model update.
-     *
-     * @param sourceId - The source model ID
-     * @param updatedData - The updated data to sync (Model instance or plain data)
-     * @param changedFields - Fields that were changed (for filtering)
-     * @returns Sync result with success status and details
-     */
-    async syncUpdate(sourceId, updatedData, changedFields) {
-        try {
-            const syncConfigs = this.getSyncConfigs();
-            if (syncConfigs.length === 0) {
-                return this.createEmptyResult();
-            }
-            const options = {
-                currentDepth: 1,
-                syncChain: [this.sourceModel.name],
-                maxDepth: DEFAULT_MAX_SYNC_DEPTH,
-                preventCircular: true,
-            };
-            const instructions = await this.collectInstructions({
-                sourceId,
-                updatedData,
-                changedFields,
-                syncConfigs,
-                options,
-            });
-            return await this.executeInstructions(instructions);
-        }
-        catch (error) {
-            // Catch-all error handler for unexpected failures
-            console.error(`Sync update failed for ${this.sourceModel.name}#${sourceId}:`, error);
-            return {
-                success: false,
-                attempted: 0,
-                succeeded: 0,
-                failed: 1,
-                errors: [
-                    {
-                        instruction: {
-                            targetTable: "",
-                            targetModel: "",
-                            filter: {},
-                            update: {},
-                            depth: 0,
-                            chain: [this.sourceModel.name],
-                            sourceModel: this.sourceModel.name,
-                            sourceId,
-                        },
-                        error: error instanceof Error ? error : new Error(String(error)),
-                    },
-                ],
-                depthReached: 0,
-                contexts: [],
-            };
-        }
-    }
-    /**
-     * Executes sync operations for a model update with a specific config.
-     * Used by ModelSyncOperation for event-based sync.
-     *
-     * @param sourceId - The source model ID
-     * @param updatedData - The updated data to sync
-     * @param changedFields - Fields that were changed
-     * @param config - The sync configuration to use
-     * @returns Sync result with success status and details
-     */
-    async syncUpdateWithConfig(sourceId, updatedData, changedFields, config) {
-        try {
-            const options = {
-                currentDepth: 1,
-                syncChain: [this.sourceModel.name],
-                maxDepth: config.maxSyncDepth,
-                preventCircular: config.preventCircularSync,
-            };
-            const instructions = await this.collectInstructions({
-                sourceId,
-                updatedData,
-                changedFields,
-                syncConfigs: [config],
-                options,
-            });
-            return await this.executeInstructions(instructions);
-        }
-        catch (error) {
-            console.error(`Sync update with config failed for ${this.sourceModel.name}#${sourceId}:`, error);
-            return {
-                success: false,
-                attempted: 0,
-                succeeded: 0,
-                failed: 1,
-                errors: [
-                    {
-                        instruction: {
-                            targetTable: "",
-                            targetModel: "",
-                            filter: {},
-                            update: {},
-                            depth: 0,
-                            chain: [this.sourceModel.name],
-                            sourceModel: this.sourceModel.name,
-                            sourceId,
-                        },
-                        error: error instanceof Error ? error : new Error(String(error)),
-                    },
-                ],
-                depthReached: 0,
-                contexts: [],
-            };
-        }
-    }
-    /**
-     * Executes sync delete operations with a specific config.
-     * Used by ModelSyncOperation for event-based sync.
-     *
-     * @param sourceId - The source model ID
-     * @param config - The sync configuration to use
-     * @returns Sync result with success status and details
-     */
-    async syncDeleteWithConfig(sourceId, config) {
-        try {
-            if (!config.unsetOnDelete) {
-                return this.createEmptyResult();
-            }
-            const options = {
-                currentDepth: 1,
-                syncChain: [this.sourceModel.name],
-                maxDepth: config.maxSyncDepth,
-                preventCircular: config.preventCircularSync,
-            };
-            const instructions = await this.collectDeleteInstructions(sourceId, [config], options);
-            return await this.executeInstructions(instructions);
-        }
-        catch (error) {
-            console.error(`Sync delete with config failed for ${this.sourceModel.name}#${sourceId}:`, error);
-            return {
-                success: false,
-                attempted: 0,
-                succeeded: 0,
-                failed: 1,
-                errors: [
-                    {
-                        instruction: {
-                            targetTable: "",
-                            targetModel: "",
-                            filter: {},
-                            update: {},
-                            depth: 0,
-                            chain: [this.sourceModel.name],
-                            sourceModel: this.sourceModel.name,
-                            sourceId,
-                        },
-                        error: error instanceof Error ? error : new Error(String(error)),
-                    },
-                ],
-                depthReached: 0,
-                contexts: [],
-            };
-        }
-    }
-    /**
-     * Executes sync operations for a model deletion.
-     *
-     * @param sourceId - The source model ID
-     * @returns Sync result with success status and details
-     */
-    async syncDelete(sourceId) {
-        try {
-            const syncConfigs = this.getSyncConfigs();
-            if (syncConfigs.length === 0) {
-                return this.createEmptyResult();
-            }
-            const options = {
-                currentDepth: 1,
-                syncChain: [this.sourceModel.name],
-                maxDepth: DEFAULT_MAX_SYNC_DEPTH,
-                preventCircular: true,
-            };
-            const instructions = await this.collectDeleteInstructions(sourceId, syncConfigs, options);
-            return await this.executeInstructions(instructions);
-        }
-        catch (error) {
-            // Catch-all error handler for unexpected failures
-            console.error(`Sync delete failed for ${this.sourceModel.name}#${sourceId}:`, error);
-            return {
-                success: false,
-                attempted: 0,
-                succeeded: 0,
-                failed: 1,
-                errors: [
-                    {
-                        instruction: {
-                            targetTable: "",
-                            targetModel: "",
-                            filter: {},
-                            update: {},
-                            depth: 0,
-                            chain: [this.sourceModel.name],
-                            sourceModel: this.sourceModel.name,
-                            sourceId,
-                        },
-                        error: error instanceof Error ? error : new Error(String(error)),
-                    },
-                ],
-                depthReached: 0,
-                contexts: [],
-            };
-        }
-    }
-    /**
-     * Collects sync instructions recursively with depth limiting.
-     *
-     * @param payload - Data payload
-     * @returns Array of sync instructions
-     */
-    async collectInstructions(payload) {
-        const { sourceId, updatedData, changedFields, syncConfigs, options } = payload;
-        const instructions = [];
-        for (const config of syncConfigs) {
-            // Check if we should sync based on watched fields
-            if (!this.shouldSync(config, changedFields)) {
-                continue;
-            }
-            // Validate depth and circular references
-            const validation = SyncContextManager.validate(options.currentDepth, options.syncChain, config.targetModelClass.name, config.maxSyncDepth, config.preventCircularSync);
-            if (!validation.valid) {
-                console.warn(`Sync validation failed: ${validation.error}`);
-                continue;
-            }
-            // Get embedded data (handle both Model instance and plain data)
-            const embedData = await this.getEmbedData(updatedData, config);
-            // Build instruction
-            const instruction = this.buildUpdateInstruction(sourceId, config, embedData, options);
-            instructions.push(instruction);
-            // Emit syncing event
-            await this.emitSyncingEvent(instruction);
-            // Recursively collect instructions for next level
-            if (SyncContextManager.canSyncDeeper(options.currentDepth, config.maxSyncDepth)) {
-                const nextLevelInstructions = await this.collectNextLevelInstructions(instruction, embedData, changedFields, config, options);
-                instructions.push(...nextLevelInstructions);
-            }
-        }
-        return instructions;
-    }
-    /**
-     * Collects delete sync instructions.
-     *
-     * @param sourceId - Source model ID
-     * @param syncConfigs - Sync configurations
-     * @param options - Instruction options
-     * @returns Array of sync instructions
-     */
-    async collectDeleteInstructions(sourceId, syncConfigs, options) {
-        const instructions = [];
-        for (const config of syncConfigs) {
-            if (!config.unsetOnDelete) {
-                continue;
-            }
-            const validation = SyncContextManager.validate(options.currentDepth, options.syncChain, config.targetModelClass.name, config.maxSyncDepth, config.preventCircularSync);
-            if (!validation.valid) {
-                continue;
-            }
-            const instruction = this.buildDeleteInstruction(sourceId, config, options);
-            instructions.push(instruction);
-            await this.emitSyncingEvent(instruction);
-        }
-        return instructions;
-    }
-    /**
-     * Collects instructions for the next level in the sync chain.
-     *
-     * @param parentInstruction - The parent instruction
-     * @param embedData - Embedded data from parent
-     * @param changedFields - Changed fields
-     * @param parentConfig - Parent sync config
-     * @param parentOptions - Parent instruction options
-     * @returns Array of next-level sync instructions
-     */
-    async collectNextLevelInstructions(parentInstruction, embedData, changedFields, parentConfig, parentOptions) {
-        const targetModelClass = parentConfig.targetModelClass;
-        const targetSyncConfigs = this.getSyncConfigsForModel(targetModelClass);
-        if (targetSyncConfigs.length === 0) {
-            return [];
-        }
-        const nextOptions = {
-            currentDepth: parentOptions.currentDepth + 1,
-            syncChain: SyncContextManager.extendChain(parentOptions.syncChain, targetModelClass.name),
-            maxDepth: Math.min(parentConfig.maxSyncDepth, parentOptions.maxDepth),
-            preventCircular: parentOptions.preventCircular && parentConfig.preventCircularSync,
-        };
-        // Get the ID from embed data for next level
-        const sourceId = embedData[parentConfig.identifierField];
-        return await this.collectInstructions({
-            sourceId,
-            updatedData: embedData,
-            changedFields,
-            syncConfigs: targetSyncConfigs,
-            options: nextOptions,
-        });
-    }
-    /**
-     * Builds an update sync instruction.
-     *
-     * @param sourceId - Source model ID
-     * @param config - Sync configuration
-     * @param embedData - Embedded data to sync
-     * @param options - Instruction options
-     * @returns Sync instruction
-     */
-    buildUpdateInstruction(sourceId, config, embedData, options) {
-        const targetModelClass = config.targetModelClass;
-        const filter = this.buildFilter(sourceId, config);
-        const update = this.buildUpdate(embedData, config);
-        const instruction = {
-            targetTable: targetModelClass.table,
-            targetModel: targetModelClass.name,
-            filter,
-            update,
-            depth: options.currentDepth,
-            chain: [...options.syncChain],
-            sourceModel: this.sourceModel.name,
-            sourceId,
-        };
-        // Add array update metadata if needed
-        if (config.isMany) {
-            instruction.isArrayUpdate = true;
-            instruction.arrayField = config.targetField;
-            instruction.identifierField = config.identifierField;
-            instruction.identifierValue = sourceId;
-        }
-        return instruction;
-    }
-    /**
-     * Builds a delete sync instruction.
-     *
-     * @param sourceId - Source model ID
-     * @param config - Sync configuration
-     * @param options - Instruction options
-     * @returns Sync instruction
-     */
-    buildDeleteInstruction(sourceId, config, options) {
-        const targetModelClass = config.targetModelClass;
-        const filter = this.buildFilter(sourceId, config);
-        const update = { $unset: { [config.targetField]: 1 } };
-        return {
-            targetTable: targetModelClass.table,
-            targetModel: targetModelClass.name,
-            filter,
-            update,
-            depth: options.currentDepth,
-            chain: [...options.syncChain],
-            sourceModel: this.sourceModel.name,
-            sourceId,
-        };
-    }
-    /**
-     * Builds a filter for identifying target documents.
-     *
-     * @param sourceId - Source model ID
-     * @param config - Sync configuration
-     * @returns Filter object
-     */
-    buildFilter(sourceId, config) {
-        if (config.isMany) {
-            // For arrays: { "products.id": productId }
-            return { [`${config.targetField}.${config.identifierField}`]: sourceId };
-        }
-        else {
-            // For single: { "category.id": categoryId }
-            return { [`${config.targetField}.${config.identifierField}`]: sourceId };
-        }
-    }
-    /**
-     * Builds an update operation for syncing data.
-     *
-     * @param embedData - Embedded data to sync
-     * @param config - Sync configuration
-     * @returns Update operation object
-     */
-    buildUpdate(embedData, config) {
-        if (config.isMany) {
-            // For arrays: use positional operator $
-            return { $set: { [`${config.targetField}.$`]: embedData } };
-        }
-        else {
-            // For single: direct set
-            return { $set: { [config.targetField]: embedData } };
-        }
-    }
-    /**
-     * Executes sync instructions with batch optimization.
-     * Groups by depth and target table for optimal batching.
-     *
-     * @param instructions - Array of sync instructions
-     * @returns Sync result
-     */
-    async executeInstructions(instructions) {
-        const result = {
-            success: true,
-            attempted: instructions.length,
-            succeeded: 0,
-            failed: 0,
-            errors: [],
-            depthReached: 0,
-            contexts: [],
-        };
-        if (instructions.length === 0) {
-            return result;
-        }
-        // Group instructions by depth for sequential execution
-        const instructionsByDepth = this.groupByDepth(instructions);
-        for (const [depth, depthInstructions] of instructionsByDepth) {
-            result.depthReached = Math.max(result.depthReached, depth);
-            // Further group by target table for better batching
-            const instructionsByTable = this.groupByTable(depthInstructions);
-            for (const [table, tableInstructions] of instructionsByTable) {
-                try {
-                    // Try batch execution first (all instructions for this table)
-                    await this.executeBatch(tableInstructions, result);
-                }
-                catch (batchError) {
-                    // Fallback to individual execution on batch failure
-                    console.warn(`Batch execution failed for table ${table} at depth ${depth}, falling back to individual execution`);
-                    await this.executeIndividual(tableInstructions, result);
-                }
-            }
-        }
-        result.success = result.failed === 0;
-        return result;
-    }
-    /**
-     * Executes instructions in batch.
-     *
-     * @param instructions - Instructions to execute
-     * @param result - Result object to update
-     */
-    async executeBatch(instructions, result) {
-        for (const instruction of instructions) {
-            try {
-                const updateResult = await this.driver.updateMany(instruction.targetTable, instruction.filter, instruction.update);
-                const context = SyncContextManager.createContext(instruction, updateResult.modifiedCount);
-                result.contexts.push(context);
-                result.succeeded++;
-                await this.emitSyncedEvent(context);
-            }
-            catch (error) {
-                throw error; // Re-throw for batch fallback
-            }
-        }
-    }
-    /**
-     * Executes instructions individually (fallback).
-     * Provides detailed error reporting for each failed instruction.
-     *
-     * @param instructions - Instructions to execute
-     * @param result - Result object to update
-     */
-    async executeIndividual(instructions, result) {
-        for (const instruction of instructions) {
-            try {
-                const updateResult = await this.driver.updateMany(instruction.targetTable, instruction.filter, instruction.update);
-                const context = SyncContextManager.createContext(instruction, updateResult.modifiedCount);
-                result.contexts.push(context);
-                result.succeeded++;
-                await this.emitSyncedEvent(context);
-            }
-            catch (error) {
-                result.failed++;
-                const errorMessage = this.formatSyncError(instruction, error);
-                const syncError = new Error(errorMessage);
-                // Preserve original error stack if available
-                if (error instanceof Error && error.stack) {
-                    syncError.stack = error.stack;
-                }
-                result.errors.push({
-                    instruction,
-                    error: syncError,
-                });
-                // Log detailed error for debugging
-                console.error(`Sync operation failed:`, {
-                    sourceModel: instruction.sourceModel,
-                    sourceId: instruction.sourceId,
-                    targetModel: instruction.targetModel,
-                    targetTable: instruction.targetTable,
-                    depth: instruction.depth,
-                    chain: SyncContextManager.formatChain(instruction.chain),
-                    filter: instruction.filter,
-                    error: errorMessage,
-                });
-            }
-        }
-    }
-    /**
-     * Formats a sync error with detailed context.
-     *
-     * @param instruction - The failed instruction
-     * @param error - The error that occurred
-     * @returns Formatted error message
-     */
-    formatSyncError(instruction, error) {
-        const baseMessage = error instanceof Error ? error.message : String(error);
-        const chain = SyncContextManager.formatChain(instruction.chain);
-        return [
-            `Sync failed at depth ${instruction.depth}:`,
-            `Chain: ${chain} → ${instruction.targetModel}`,
-            `Source: ${instruction.sourceModel}#${instruction.sourceId}`,
-            `Target: ${instruction.targetTable}`,
-            `Error: ${baseMessage}`,
-        ].join(" | ");
-    }
-    /**
-     * Groups instructions by depth for batch processing.
-     *
-     * @param instructions - Instructions to group
-     * @returns Map of depth to instructions (sorted ascending)
-     */
-    groupByDepth(instructions) {
-        const grouped = new Map();
-        for (const instruction of instructions) {
-            const depth = instruction.depth;
-            if (!grouped.has(depth)) {
-                grouped.set(depth, []);
-            }
-            grouped.get(depth).push(instruction);
-        }
-        // Sort by depth (ascending) for sequential execution
-        return new Map([...grouped.entries()].sort((a, b) => a[0] - b[0]));
-    }
-    /**
-     * Groups instructions by target table for batch optimization.
-     *
-     * @param instructions - Instructions to group
-     * @returns Map of table name to instructions
-     */
-    groupByTable(instructions) {
-        const grouped = new Map();
-        for (const instruction of instructions) {
-            const table = instruction.targetTable;
-            if (!grouped.has(table)) {
-                grouped.set(table, []);
-            }
-            grouped.get(table).push(instruction);
-        }
-        return grouped;
-    }
-    /**
-     * Checks if sync should proceed based on watched fields.
-     *
-     * @param config - Sync configuration
-     * @param changedFields - Fields that changed
-     * @returns True if sync should proceed
-     */
-    shouldSync(config, changedFields) {
-        if (config.watchFields.length === 0) {
-            return true; // Watch all fields
-        }
-        return config.watchFields.some((field) => changedFields.includes(field));
-    }
-    /**
-     * Gets embedded data from the source model.
-     *
-     * @param data - Source model data or Model instance
-     * @param config - Sync configuration
-     * @returns Embedded data
-     */
-    async getEmbedData(data, config) {
-        // If data is a Model instance, call the embed method on it
-        if (data instanceof Model) {
-            if (Array.isArray(config.embedKey)) {
-                return data.only(config.embedKey);
-            }
-            if (typeof data[config.embedKey] !== "function") {
-                return data[config.embedKey];
-            }
-            // Fallback: use embedData() if available
-            if (typeof data.embedData === "function") {
-                return data.embedData;
-            }
-            // Last resort: return model data
-            return data.data;
-        }
-        // Otherwise, return the data as-is
-        return data;
-    }
-    /**
-     * Gets sync configurations from the source model.
-     *
-     * @returns Array of sync configurations
-     */
-    getSyncConfigs() {
-        const syncWith = this.sourceModel.syncWith;
-        if (!syncWith || !Array.isArray(syncWith)) {
-            return [];
-        }
-        return syncWith.map((builder) => typeof builder.build === "function" ? builder.build() : builder);
-    }
-    /**
-     * Gets sync configurations for a specific model.
-     *
-     * @param modelClass - The model class
-     * @returns Array of sync configurations
-     */
-    getSyncConfigsForModel(modelClass) {
-        const syncWith = modelClass.syncWith;
-        if (!syncWith || !Array.isArray(syncWith)) {
-            return [];
-        }
-        return syncWith.map((builder) => typeof builder.build === "function" ? builder.build() : builder);
-    }
-    /**
-     * Emits a syncing event.
-     *
-     * @param instruction - The sync instruction
-     */
-    async emitSyncingEvent(instruction) {
-        const payload = {
-            sourceModel: instruction.sourceModel,
-            sourceId: instruction.sourceId,
-            targetModel: instruction.targetModel,
-            filter: instruction.filter,
-            update: instruction.update,
-            affectedCount: 0,
-            depth: instruction.depth,
-            chain: instruction.chain,
-        };
-        // Emit on source model
-        if (typeof this.sourceModel.emitSyncEvent === "function") {
-            await this.sourceModel.emitSyncEvent("syncing", payload);
-        }
-    }
-    /**
-     * Emits a synced event.
-     *
-     * @param context - The sync context
-     */
-    async emitSyncedEvent(context) {
-        const payload = {
-            sourceModel: context.sourceModel,
-            sourceId: context.sourceId,
-            targetModel: context.targetModel,
-            filter: context.filter,
-            update: context.update,
-            affectedCount: context.affectedCount,
-            depth: context.currentDepth,
-            chain: context.syncChain,
-        };
-        // Emit on source model
-        if (typeof this.sourceModel.emitSyncEvent === "function") {
-            await this.sourceModel.emitSyncEvent("synced", payload);
-        }
-    }
-    /**
-     * Creates an empty sync result.
-     *
-     * @returns Empty sync result
-     */
-    createEmptyResult() {
-        return {
-            success: true,
-            attempted: 0,
-            succeeded: 0,
-            failed: 0,
-            errors: [],
-            depthReached: 0,
-            contexts: [],
-        };
-    }
-}export{SyncManager};//# sourceMappingURL=sync-manager.js.map