@warlock.js/cascade 4.0.48 → 4.0.58

package/esm/sync/model-sync-operation.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Model sync operation class.
+ *
+ * Manages a single sync relationship between a source and target model.
+ * Subscribes to source model events and triggers sync operations when
+ * the source is updated or deleted.
+ *
+ * @module cascade-next/sync/model-sync-operation
+ */
+import type { ChildModel, Model } from "../model/model";
+import type { ModelSyncConfig, ModelSyncOperationContract } from "./types";
+/**
+ * Manages a single model sync operation.
+ *
+ * Subscribes to source model events (updated, deleted) and triggers
+ * sync operations to update embedded data in target models.
+ *
+ * @example
+ * ```typescript
+ * // Created via modelSync.sync() or Model.sync()
+ * const operation = new ModelSyncOperation(Category, Product, "category", false);
+ * operation
+ *   .embed("embedMinimal")
+ *   .watchFields(["name", "slug"])
+ *   .unsetOnDelete();
+ * ```
+ */
+export declare class ModelSyncOperation implements ModelSyncOperationContract {
+    /**
+     * Configuration for this sync operation.
+     */
+    private readonly config;
+    /**
+     * Active event subscriptions for cleanup.
+     */
+    private readonly subscriptions;
+    /**
+     * Whether this operation is currently subscribed to events.
+     */
+    private isSubscribed;
+    /**
+     * Create a new model sync operation.
+     *
+     * @param sourceModel - Source model class that triggers sync
+     * @param targetModel - Target model class that receives data
+     * @param targetField - Field path in target model
+     * @param isMany - Whether this syncs to an array field
+     */
+    constructor(sourceModelClass: ChildModel<Model>, targetModelClass: ChildModel<Model>, targetField: string, isMany: boolean);
+    /**
+     * Set the embed method to call on source model.
+     *
+     * @param embed - getter property name (e.g., "embedData", "embedMinimal") Or Array of fields
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").embed("embedMinimal");
+     * ```
+     */
+    embed(method: string | string[]): this;
+    /**
+     * Set the identifier field for array matching.
+     * Required when syncing to array fields (syncMany).
+     *
+     * @param field - Field name used as identifier (default: "id")
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Tag.syncMany(Post, "tags").identifyBy("tagId");
+     * ```
+     */
+    identifyBy(field: string): this;
+    /**
+     * Set the maximum sync depth for chained operations.
+     *
+     * @param depth - Maximum depth (default: 3)
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").maxDepth(2);
+     * ```
+     */
+    maxDepth(depth: number): this;
+    /**
+     * Set which fields to watch for changes.
+     * Sync only triggers when these fields change.
+     *
+     * @param fields - Array of field names to watch (empty = all)
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").watchFields(["name", "slug"]);
+     * ```
+     */
+    watchFields(fields: string[]): this;
+    /**
+     * Unset the target field when source is deleted.
+     *
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").unsetOnDelete();
+     * ```
+     */
+    unsetOnDelete(): this;
+    /**
+     * Delete target documents when source is deleted.
+     *
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * User.sync(Profile, "user").removeOnDelete();
+     * ```
+     */
+    removeOnDelete(): this;
+    /**
+     * Subscribe to source model events.
+     * Called automatically in constructor.
+     */
+    private subscribe;
+    /**
+     * Unsubscribe from all events and cleanup.
+     * Called automatically when using modelSync.register().
+     */
+    unsubscribe(): void;
+    /**
+     * Cleanup the sync operations
+     */
+    $cleanup(): void;
+    /**
+     * Handle model updated event.
+     * Triggers sync to update embedded data in target models.
+     */
+    private handleModelUpdated;
+    /**
+     * Handle model deleted event.
+     * Triggers unset or remove based on configuration.
+     */
+    private handleModelDeleted;
+    /**
+     * Check if sync should proceed based on watched fields.
+     */
+    private shouldSync;
+    /**
+     * Build sync config compatible with SyncManager.
+     */
+    private buildSyncConfig;
+    /**
+     * Remove target documents that reference the deleted source.
+     */
+    private removeTargetDocuments;
+    /**
+     * Get the current configuration (for debugging/testing).
+     */
+    getConfig(): Readonly<ModelSyncConfig>;
+}
+//# sourceMappingURL=model-sync-operation.d.ts.map

package/esm/sync/model-sync-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-sync-operation.d.ts","sourceRoot":"","sources":["../../src/sync/model-sync-operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,YAAW,0BAA0B;IACnE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IAEzD;;OAEG;IACH,OAAO,CAAC,YAAY,CAAS;IAE7B;;;;;;;OAOG;gBAED,gBAAgB,EAAE,UAAU,CAAC,KAAK,CAAC,EACnC,gBAAgB,EAAE,UAAU,CAAC,KAAK,CAAC,EACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,OAAO;IAsBjB;;;;;;;;;;OAUG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAK7C;;;;;;;;;;;OAWG;IACI,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKtC;;;;;;;;;;OAUG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKpC;;;;;;;;;;;OAWG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAK1C;;;;;;;;;OASG;IACI,aAAa,IAAI,IAAI;IAK5B;;;;;;;;;OASG;IACI,cAAc,IAAI,IAAI;IAS7B;;;OAGG;IACH,OAAO,CAAC,SAAS;IAoBjB;;;OAGG;IACI,WAAW,IAAI,IAAI;IAS1B;;OAEG;IACI,QAAQ;IAQf;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAgCxB;IAEF;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CA8BxB;IAMF;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;YACW,qBAAqB;IAQnC;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC;CAG9C"}

package/esm/sync/model-sync-operation.js

@@ -0,0 +1,292 @@
+import events from'@mongez/events';import {getModelUpdatedEvent,getModelDeletedEvent}from'./model-events.js';import {DEFAULT_MAX_SYNC_DEPTH}from'./sync-context.js';import {SyncManager}from'./sync-manager.js';/**
+ * Model sync operation class.
+ *
+ * Manages a single sync relationship between a source and target model.
+ * Subscribes to source model events and triggers sync operations when
+ * the source is updated or deleted.
+ *
+ * @module cascade-next/sync/model-sync-operation
+ */
+/**
+ * Manages a single model sync operation.
+ *
+ * Subscribes to source model events (updated, deleted) and triggers
+ * sync operations to update embedded data in target models.
+ *
+ * @example
+ * ```typescript
+ * // Created via modelSync.sync() or Model.sync()
+ * const operation = new ModelSyncOperation(Category, Product, "category", false);
+ * operation
+ *   .embed("embedMinimal")
+ *   .watchFields(["name", "slug"])
+ *   .unsetOnDelete();
+ * ```
+ */
+class ModelSyncOperation {
+    /**
+     * Configuration for this sync operation.
+     */
+    config;
+    /**
+     * Active event subscriptions for cleanup.
+     */
+    subscriptions = [];
+    /**
+     * Whether this operation is currently subscribed to events.
+     */
+    isSubscribed = false;
+    /**
+     * Create a new model sync operation.
+     *
+     * @param sourceModel - Source model class that triggers sync
+     * @param targetModel - Target model class that receives data
+     * @param targetField - Field path in target model
+     * @param isMany - Whether this syncs to an array field
+     */
+    constructor(sourceModelClass, targetModelClass, targetField, isMany) {
+        this.config = {
+            sourceModel: sourceModelClass,
+            targetModel: targetModelClass,
+            targetField,
+            isMany,
+            embedKey: "embedData",
+            identifierField: "id",
+            maxSyncDepth: DEFAULT_MAX_SYNC_DEPTH,
+            watchFields: [],
+            unsetOnDelete: false,
+            removeOnDelete: false,
+        };
+        this.subscribe();
+    }
+    // ============================================================================
+    // FLUENT CONFIGURATION
+    // ============================================================================
+    /**
+     * Set the embed method to call on source model.
+     *
+     * @param embed - getter property name (e.g., "embedData", "embedMinimal") Or Array of fields
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").embed("embedMinimal");
+     * ```
+     */
+    embed(method) {
+        this.config.embedKey = method;
+        return this;
+    }
+    /**
+     * Set the identifier field for array matching.
+     * Required when syncing to array fields (syncMany).
+     *
+     * @param field - Field name used as identifier (default: "id")
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Tag.syncMany(Post, "tags").identifyBy("tagId");
+     * ```
+     */
+    identifyBy(field) {
+        this.config.identifierField = field;
+        return this;
+    }
+    /**
+     * Set the maximum sync depth for chained operations.
+     *
+     * @param depth - Maximum depth (default: 3)
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").maxDepth(2);
+     * ```
+     */
+    maxDepth(depth) {
+        this.config.maxSyncDepth = depth;
+        return this;
+    }
+    /**
+     * Set which fields to watch for changes.
+     * Sync only triggers when these fields change.
+     *
+     * @param fields - Array of field names to watch (empty = all)
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").watchFields(["name", "slug"]);
+     * ```
+     */
+    watchFields(fields) {
+        this.config.watchFields = fields;
+        return this;
+    }
+    /**
+     * Unset the target field when source is deleted.
+     *
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * Category.sync(Product, "category").unsetOnDelete();
+     * ```
+     */
+    unsetOnDelete() {
+        this.config.unsetOnDelete = true;
+        return this;
+    }
+    /**
+     * Delete target documents when source is deleted.
+     *
+     * @returns This operation for chaining
+     *
+     * @example
+     * ```typescript
+     * User.sync(Profile, "user").removeOnDelete();
+     * ```
+     */
+    removeOnDelete() {
+        this.config.removeOnDelete = true;
+        return this;
+    }
+    // ============================================================================
+    // LIFECYCLE
+    // ============================================================================
+    /**
+     * Subscribe to source model events.
+     * Called automatically in constructor.
+     */
+    subscribe() {
+        if (this.isSubscribed) {
+            return;
+        }
+        const sourceModel = this.config.sourceModel;
+        // Subscribe to model.updated event
+        this.subscriptions.push(events.subscribe(getModelUpdatedEvent(sourceModel), this.handleModelUpdated));
+        // Subscribe to model.deleted event
+        this.subscriptions.push(events.subscribe(getModelDeletedEvent(sourceModel), this.handleModelDeleted));
+        this.isSubscribed = true;
+    }
+    /**
+     * Unsubscribe from all events and cleanup.
+     * Called automatically when using modelSync.register().
+     */
+    unsubscribe() {
+        for (const subscription of this.subscriptions) {
+            subscription.unsubscribe();
+        }
+        this.subscriptions.length = 0;
+        this.isSubscribed = false;
+    }
+    /**
+     * Cleanup the sync operations
+     */
+    $cleanup() {
+        return this.unsubscribe();
+    }
+    // ============================================================================
+    // EVENT HANDLERS
+    // ============================================================================
+    /**
+     * Handle model updated event.
+     * Triggers sync to update embedded data in target models.
+     */
+    handleModelUpdated = async (model, changedFields) => {
+        // Check if we should sync based on watched fields
+        if (!this.shouldSync(changedFields)) {
+            return;
+        }
+        try {
+            const primaryKey = this.config.sourceModel.primaryKey || "id";
+            const sourceId = model.get(primaryKey);
+            if (!sourceId) {
+                return;
+            }
+            // Get the driver from the source model's data source
+            const dataSource = this.config.sourceModel.getDataSource();
+            const driver = dataSource.driver;
+            // Create sync manager and execute
+            const syncManager = new SyncManager(this.config.sourceModel, driver);
+            await syncManager.syncUpdateWithConfig(sourceId, model, changedFields, this.buildSyncConfig());
+        }
+        catch (error) {
+            console.error(`[ModelSync] Failed to sync ${this.config.sourceModel.name} -> ${this.config.targetModel.name}:`, error);
+        }
+    };
+    /**
+     * Handle model deleted event.
+     * Triggers unset or remove based on configuration.
+     */
+    handleModelDeleted = async (model) => {
+        if (!this.config.unsetOnDelete && !this.config.removeOnDelete) {
+            return;
+        }
+        try {
+            const primaryKey = this.config.sourceModel.primaryKey || "id";
+            const sourceId = model.get(primaryKey);
+            if (!sourceId) {
+                return;
+            }
+            const dataSource = this.config.sourceModel.getDataSource();
+            const driver = dataSource.driver;
+            if (this.config.removeOnDelete) {
+                // Delete all target documents that reference this source
+                await this.removeTargetDocuments(sourceId, driver);
+            }
+            else if (this.config.unsetOnDelete) {
+                // Unset the field in target documents
+                const syncManager = new SyncManager(this.config.sourceModel, driver);
+                await syncManager.syncDeleteWithConfig(sourceId, this.buildSyncConfig());
+            }
+        }
+        catch (error) {
+            console.error(`[ModelSync] Failed to handle delete for ${this.config.sourceModel.name}:`, error);
+        }
+    };
+    // ============================================================================
+    // HELPERS
+    // ============================================================================
+    /**
+     * Check if sync should proceed based on watched fields.
+     */
+    shouldSync(changedFields) {
+        if (this.config.watchFields.length === 0) {
+            return true; // Watch all fields
+        }
+        return this.config.watchFields.some((field) => changedFields.includes(field));
+    }
+    /**
+     * Build sync config compatible with SyncManager.
+     */
+    buildSyncConfig() {
+        return {
+            targetField: this.config.targetField,
+            isMany: this.config.isMany,
+            embedKey: this.config.embedKey,
+            identifierField: this.config.identifierField,
+            maxSyncDepth: this.config.maxSyncDepth,
+            preventCircularSync: true,
+            watchFields: this.config.watchFields,
+            unsetOnDelete: this.config.unsetOnDelete,
+            targetModelClass: this.config.targetModel,
+        };
+    }
+    /**
+     * Remove target documents that reference the deleted source.
+     */
+    async removeTargetDocuments(sourceId, driver) {
+        const filter = this.config.isMany
+            ? { [`${this.config.targetField}.${this.config.identifierField}`]: sourceId }
+            : { [`${this.config.targetField}.${this.config.identifierField}`]: sourceId };
+        await driver.deleteMany(this.config.targetModel.table, filter);
+    }
+    /**
+     * Get the current configuration (for debugging/testing).
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}export{ModelSyncOperation};//# sourceMappingURL=model-sync-operation.js.map

package/esm/sync/model-sync-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-sync-operation.js","sources":["../../src/sync/model-sync-operation.ts"],"sourcesContent":[null],"names":[],"mappings":"gNAAA;;;;;;;;AAQG;AASH;;;;;;;;;;;;;;;AAeG;MACU,kBAAkB,CAAA;AAC7B;;AAEG;AACc,IAAA,MAAM,CAAkB;AAEzC;;AAEG;IACc,aAAa,GAAwB,EAAE,CAAC;AAEzD;;AAEG;IACK,YAAY,GAAG,KAAK,CAAC;AAE7B;;;;;;;AAOG;AACH,IAAA,WAAA,CACE,gBAAmC,EACnC,gBAAmC,EACnC,WAAmB,EACnB,MAAe,EAAA;QAEf,IAAI,CAAC,MAAM,GAAG;AACZ,YAAA,WAAW,EAAE,gBAAgB;AAC7B,YAAA,WAAW,EAAE,gBAAgB;YAC7B,WAAW;YACX,MAAM;AACN,YAAA,QAAQ,EAAE,WAAW;AACrB,YAAA,eAAe,EAAE,IAAI;AACrB,YAAA,YAAY,EAAE,sBAAsB;AACpC,YAAA,WAAW,EAAE,EAAE;AACf,YAAA,aAAa,EAAE,KAAK;AACpB,YAAA,cAAc,EAAE,KAAK;SACtB,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;KAClB;;;;AAMD;;;;;;;;;;AAUG;AACI,IAAA,KAAK,CAAC,MAAyB,EAAA;AACpC,QAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;AAC9B,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;;AAWG;AACI,IAAA,UAAU,CAAC,KAAa,EAAA;AAC7B,QAAA,IAAI,CAAC,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;AACpC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;AAUG;AACI,IAAA,QAAQ,CAAC,KAAa,EAAA;AAC3B,QAAA,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;AACjC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;;;AAWG;AACI,IAAA,WAAW,CAAC,MAAgB,EAAA;AACjC,QAAA,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;AACjC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;AASG;IACI,aAAa,GAAA;AAClB,QAAA,IAAI,CAAC,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;AACjC,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;;;;;;;;AASG;IACI,cAAc,GAAA;AACnB,QAAA,IAAI,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;AAClC,QAAA,OAAO,IAAI,CAAC;KACb;;;;AAMD;;;AAGG;IACK,SAAS,GAAA;QACf,IAAI,IAAI,CAAC,YAAY,EAAE;YACrB,OAAO;AACR,SAAA;AAED,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;;AAG5C,QAAA,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,MAAM,CAAC,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAC7E,CAAC;;AAGF,QAAA,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,MAAM,CAAC,SAAS,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAC7E,CAAC;AAEF,QAAA,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;KAC1B;AAED;;;AAGG;IACI,WAAW,GAAA;AAChB,QAAA,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,aAAa,EAAE;YAC7C,YAAY,CAAC,WAAW,EAAE,CAAC;AAC5B,SAAA;AAED,QAAA,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9B,QAAA,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;KAC3B;AAED;;AAEG;IACI,QAAQ,GAAA;AACb,QAAA,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;KAC3B;;;;AAMD;;;AAGG;AACK,IAAA,kBAAkB,GAAG,OAAO,KAAY,EAAE,aAAuB,KAAmB;;AAE1F,QAAA,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE;YACnC,OAAO;AACR,SAAA;QAED,IAAI;YACF,MAAM,UAAU,GAAI,IAAI,CAAC,MAAM,CAAC,WAAmB,CAAC,UAAU,IAAI,IAAI,CAAC;YACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAoB,CAAC;YAE1D,IAAI,CAAC,QAAQ,EAAE;gBACb,OAAO;AACR,aAAA;;YAGD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;AAC3D,YAAA,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;;AAGjC,YAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACrE,YAAA,MAAM,WAAW,CAAC,oBAAoB,CACpC,QAAQ,EACR,KAAK,EACL,aAAa,EACb,IAAI,CAAC,eAAe,EAAE,CACvB,CAAC;AACH,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;YACd,OAAO,CAAC,KAAK,CACX,CAAA,2BAAA,EAA8B,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAG,CAAA,CAAA,EAChG,KAAK,CACN,CAAC;AACH,SAAA;AACH,KAAC,CAAC;AAEF;;;AAGG;AACK,IAAA,kBAAkB,GAAG,OAAO,KAAY,KAAmB;AACjE,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;YAC7D,OAAO;AACR,SAAA;QAED,IAAI;YACF,MAAM,UAAU,GAAI,IAAI,CAAC,MAAM,CAAC,WAAmB,CAAC,UAAU,IAAI,IAAI,CAAC;YACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAoB,CAAC;YAE1D,IAAI,CAAC,QAAQ,EAAE;gBACb,OAAO;AACR,aAAA;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;AAC3D,YAAA,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAEjC,YAAA,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;;gBAE9B,MAAM,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACpD,aAAA;AAAM,iBAAA,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;;AAEpC,gBAAA,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;gBACrE,MAAM,WAAW,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;AAC1E,aAAA;AACF,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,OAAO,CAAC,KAAK,CACX,CAAA,wCAAA,EAA2C,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAA,CAAA,CAAG,EAC1E,KAAK,CACN,CAAC;AACH,SAAA;AACH,KAAC,CAAC;;;;AAMF;;AAEG;AACK,IAAA,UAAU,CAAC,aAAuB,EAAA;QACxC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;YACxC,OAAO,IAAI,CAAC;AACb,SAAA;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;KAC/E;AAED;;AAEG;IACK,eAAe,GAAA;QACrB,OAAO;AACL,YAAA,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;AACpC,YAAA,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;AAC1B,YAAA,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;AAC9B,YAAA,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;AAC5C,YAAA,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;AACtC,YAAA,mBAAmB,EAAE,IAAI;AACzB,YAAA,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;AACpC,YAAA,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;AACxC,YAAA,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SAC1C,CAAC;KACH;AAED;;AAEG;AACK,IAAA,MAAM,qBAAqB,CAAC,QAAyB,EAAE,MAAW,EAAA;AACxE,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;AAC/B,cAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,QAAQ,EAAE;cAC3E,EAAE,CAAC,CAAA,EAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAA,CAAA,EAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAA,CAAE,GAAG,QAAQ,EAAE,CAAC;AAEhF,QAAA,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;KAChE;AAED;;AAEG;IACI,SAAS,GAAA;AACd,QAAA,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;KAC3B;AACF"}

package/esm/sync/model-sync.d.ts

@@ -0,0 +1,130 @@
+/**
+ * ModelSync facade for registering sync operations.
+ *
+ * Provides a clean API for defining sync relationships between models
+ * with automatic cleanup support for HMR (Hot Module Replacement).
+ *
+ * @module cascade-next/sync/model-sync
+ */
+import type { ChildModel, Model } from "../model/model";
+import type { ModelSyncContract, ModelSyncOperationContract } from "./types";
+/**
+ * ModelSync facade implementation.
+ *
+ * Manages sync operation registration with scoped cleanup support.
+ * Uses a registration stack to track operations created during
+ * a `register()` callback for proper HMR cleanup.
+ *
+ * @example
+ * ```typescript
+ * // In events file
+ * export const cleanup = modelSync.register(() => {
+ *   Category.sync(Product, "category");
+ *   Tag.syncMany(Post, "tags").identifyBy("id");
+ * });
+ * ```
+ */
+declare class ModelSyncFacade implements ModelSyncContract {
+    /**
+     * All active sync operations.
+     */
+    private readonly operations;
+    /**
+     * Stack for tracking operations during register() callbacks.
+     * Each element is an array of operations created in that scope.
+     */
+    private readonly registrationStack;
+    /**
+     * Create a sync operation for a single embedded document.
+     *
+     * When the source model is updated, the target model's field
+     * will be updated with the embedded data.
+     *
+     * @param source - Source model class that triggers sync
+     * @param target - Target model class that receives data
+     * @param field - Field path in target model
+     * @returns Sync operation for chaining configuration
+     *
+     * @example
+     * ```typescript
+     * // When Category updates, update Product.category
+     * modelSync.sync(Category, Product, "category");
+     *
+     * // With configuration
+     * modelSync.sync(Category, Product, "category")
+     *   .embed("embedMinimal")
+     *   .watchFields(["name", "slug"]);
+     * ```
+     */
+    sync(source: ChildModel<Model>, target: ChildModel<Model>, field: string): ModelSyncOperationContract;
+    /**
+     * Create a sync operation for an array of embedded documents.
+     *
+     * When the source model is updated, the corresponding element
+     * in the target model's array field will be updated.
+     *
+     * @param source - Source model class that triggers sync
+     * @param target - Target model class that receives data
+     * @param field - Array field path in target model
+     * @returns Sync operation for chaining configuration
+     *
+     * @example
+     * ```typescript
+     * // When Tag updates, update Post.tags[i] where tags[i].id matches
+     * modelSync.syncMany(Tag, Post, "tags").identifyBy("id");
+     * ```
+     */
+    syncMany(source: ChildModel<Model>, target: ChildModel<Model>, field: string): ModelSyncOperationContract;
+    /**
+     * Register sync operations with automatic cleanup.
+     *
+     * Executes the callback function which should contain sync registrations.
+     * Returns a cleanup function that unsubscribes all operations created
+     * during the callback - perfect for HMR module cleanup.
+     *
+     * @param callback - Function that registers sync operations
+     * @returns Cleanup function that unsubscribes all registered operations
+     *
+     * @example
+     * ```typescript
+     * // In src/app/blog/events/sync.ts
+     * export const cleanup = modelSync.register(() => {
+     *   Category.sync(Product, "category");
+     *   Tag.syncMany(Post, "tags").identifyBy("id");
+     *   Author.sync(Article, "author").unsetOnDelete();
+     * });
+     * ```
+     */
+    register(callback: () => void): () => void;
+    /**
+     * Clear all registered sync operations.
+     * Useful for testing or complete reset.
+     */
+    clear(): void;
+    /**
+     * Get count of active sync operations.
+     * Useful for debugging and testing.
+     */
+    get count(): number;
+    /**
+     * Track a new operation in global list and current registration scope.
+     */
+    private trackOperation;
+}
+/**
+ * Global modelSync facade instance.
+ *
+ * Use this to register sync operations between models.
+ *
+ * @example
+ * ```typescript
+ * import { modelSync } from "@warlock.js/cascade";
+ *
+ * export const cleanup = modelSync.register(() => {
+ *   Category.sync(Product, "category");
+ * });
+ * ```
+ */
+export declare const modelSync: ModelSyncFacade;
+export {};
+//# sourceMappingURL=model-sync.d.ts.map

package/esm/sync/model-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-sync.d.ts","sourceRoot":"","sources":["../../src/sync/model-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,cAAM,eAAgB,YAAW,iBAAiB;IAChD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8B;IAMhE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,IAAI,CACT,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EACzB,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EACzB,KAAK,EAAE,MAAM,GACZ,0BAA0B;IAM7B;;;;;;;;;;;;;;;;OAgBG;IACI,QAAQ,CACb,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EACzB,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,EACzB,KAAK,EAAE,MAAM,GACZ,0BAA0B;IAM7B;;;;;;;;;;;;;;;;;;;OAmBG;IACI,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IA2BjD;;;OAGG;IACI,KAAK,IAAI,IAAI;IAOpB;;;OAGG;IACH,IAAW,KAAK,IAAI,MAAM,CAEzB;IAMD;;OAEG;IACH,OAAO,CAAC,cAAc;CAUvB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,iBAAwB,CAAC"}