@warlock.js/cascade 4.0.174 → 4.1.1

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

@@ -0,0 +1,159 @@
+import { ChildModel } from "../model/model.types.mjs";
+import { ModelSyncConfig, ModelSyncOperationContract } from "./types.mjs";
+import { Model } from "../model/model.mjs";
+
+//#region ../../@warlock.js/cascade/src/sync/model-sync-operation.d.ts
+/**
+ * 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();
+ * ```
+ */
+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>;
+}
+//#endregion
+export { ModelSyncOperation };
+//# sourceMappingURL=model-sync-operation.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-sync-operation.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/sync/model-sync-operation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAiCa,kBAAA,YAA8B,0BAAA;EA2BvC;;;EAAA,iBAvBe,MAAA;EA0EV;;;EAAA,iBArEU,aAAA;EAsGV;;;EAAA,QAjGC,YAAA;EA4IA;;;;;;;;cAjIN,gBAAA,EAAkB,UAAA,CAAW,KAAA,GAC7B,gBAAA,EAAkB,UAAA,CAAW,KAAA,GAC7B,WAAA,UACA,MAAA;EAkSkB;;;AAAwB;;;;;;;;EAjQrC,KAAA,CAAM,MAAA;;;;;;;;;;;;;EAiBN,UAAA,CAAW,KAAA;;;;;;;;;;;;EAgBX,QAAA,CAAS,KAAA;;;;;;;;;;;;;EAiBT,WAAA,CAAY,MAAA;;;;;;;;;;;EAeZ,aAAA,CAAA;;;;;;;;;;;EAeA,cAAA,CAAA;;;;;UAaC,SAAA;;;;;EAwBD,WAAA,CAAA;;;;EAYA,QAAA,CAAA;;;;;UAYC,kBAAA;;;;;UAsCA,kBAAA;;;;UAuCA,UAAA;;;;UAWA,eAAA;;;;UAiBM,qBAAA;;;;EAWP,SAAA,CAAA,GAAa,QAAA,CAAS,eAAA;AAAA"}

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

@@ -0,0 +1,257 @@
+import { getModelDeletedEvent, getModelUpdatedEvent } from "./model-events.mjs";
+import { DEFAULT_MAX_SYNC_DEPTH } from "./sync-context.mjs";
+import { SyncManager } from "./sync-manager.mjs";
+import events from "@mongez/events";
+
+//#region ../../@warlock.js/cascade/src/sync/model-sync-operation.ts
+/**
+* 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();
+* ```
+*/
+var ModelSyncOperation = class {
+	/**
+	* 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: 3,
+			watchFields: [],
+			unsetOnDelete: false,
+			removeOnDelete: false
+		};
+		this.subscribe();
+	}
+	/**
+	* 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;
+	}
+	/**
+	* Subscribe to source model events.
+	* Called automatically in constructor.
+	*/
+	subscribe() {
+		if (this.isSubscribed) return;
+		const sourceModel = this.config.sourceModel;
+		this.subscriptions.push(events.subscribe(getModelUpdatedEvent(sourceModel), this.handleModelUpdated));
+		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();
+	}
+	/**
+	* Handle model updated event.
+	* Triggers sync to update embedded data in target models.
+	*/
+	handleModelUpdated = async (model, changedFields) => {
+		if (!this.shouldSync(changedFields)) return;
+		try {
+			const primaryKey = this.config.sourceModel.primaryKey || "id";
+			const sourceId = model.get(primaryKey);
+			if (!sourceId) return;
+			const driver = this.config.sourceModel.getDataSource().driver;
+			await new SyncManager(this.config.sourceModel, driver).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 driver = this.config.sourceModel.getDataSource().driver;
+			if (this.config.removeOnDelete) await this.removeTargetDocuments(sourceId, driver);
+			else if (this.config.unsetOnDelete) await new SyncManager(this.config.sourceModel, driver).syncDeleteWithConfig(sourceId, this.buildSyncConfig());
+		} catch (error) {
+			console.error(`[ModelSync] Failed to handle delete for ${this.config.sourceModel.name}:`, error);
+		}
+	};
+	/**
+	* Check if sync should proceed based on watched fields.
+	*/
+	shouldSync(changedFields) {
+		if (this.config.watchFields.length === 0) return true;
+		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 };
+	}
+};
+
+//#endregion
+export { ModelSyncOperation };
+//# sourceMappingURL=model-sync-operation.mjs.map

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

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

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

@@ -0,0 +1,126 @@
+import { ChildModel } from "../model/model.types.mjs";
+import { ModelSyncContract, ModelSyncOperationContract } from "./types.mjs";
+import { Model } from "../model/model.mjs";
+
+//#region ../../@warlock.js/cascade/src/sync/model-sync.d.ts
+/**
+ * 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");
+ * });
+ * ```
+ */
+declare const modelSync: ModelSyncFacade;
+//#endregion
+export { modelSync };
+//# sourceMappingURL=model-sync.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-sync.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/sync/model-sync.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cA6BM,eAAA,YAA2B,iBAAA;EAuC7B;;;EAAA,iBAnCe,UAAA;EAqCf;;;;EAAA,iBA/Be,iBAAA;EAwDf;;;;;;;;;;;;AAkFoB;AA0BxB;;;;AAA8C;;;;;EAxIrC,IAAA,CACL,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;;;;;;;;;;EAuBI,QAAA,CACL,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;;;;;;;;;;;;;EA0BI,QAAA,CAAS,QAAA;;;;;EA+BT,KAAA,CAAA;;;;;MAWI,KAAA,CAAA;;;;UAWH,cAAA;AAAA;;;;;;;;;;;;;;;cA0BG,SAAA,EAAS,eAAwB"}