@warp-drive/core 5.9.0-beta.1 → 5.9.0-beta.3

package/dist/unpkg/prod/graph/-private.js

@@ -1,4 +1,4 @@
-import { a as setTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-BK71-uXR.js";
+import { a as setTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-B6aLbrgV.js";
 
 //#region src/graph/-private/-utils.ts
 /** Retrieves the private {@link Store} instance from a capabilities manager (or any object exposing `_store`). */
@@ -81,12 +81,12 @@ function removeIdentifierCompletelyFromRelationship(graph, relationship, value,
 	}
 }
 /** Notifies the store that a relationship has changed, provided the relationship has been accessed and is not currently being removed. */
-function notifyChange(graph, relationship) {
+function notifyChange(graph, relationship, channel) {
 	if (!relationship.accessed) return;
 	const resourceKey = relationship.identifier;
 	const key = relationship.definition.key;
 	if (resourceKey === graph._removing) return;
-	graph.store.notifyChange(resourceKey, "relationships", key);
+	graph.store.notifyChange(resourceKey, "relationships", key, channel);
 }
 
 //#endregion
@@ -138,13 +138,13 @@ function replaceRelatedRecordsLocal(graph, op, isRemote) {
 	relationship.additions = diff.add;
 	relationship.removals = diff.del;
 	relationship.localState = diff.finalState;
-	if (becameDirty && !wasDirty) notifyChange(graph, relationship);
+	if (becameDirty && !wasDirty) notifyChange(graph, relationship, "local");
 }
 function replaceRelatedRecordsRemote(graph, op, isRemote) {
 	const resourceKeys = op.value;
 	const relationship = graph.get(op.record, op.field);
 	if (isRemote) graph._addToTransaction(relationship);
-	const wasDirty = relationship.isDirty;
+	relationship.isDirty;
 	if (!relationship.state.hasReceivedData) relationship.isDirty = true;
 	relationship.state.hasReceivedData = true;
 	const { definition } = relationship;
@@ -161,7 +161,8 @@ function replaceRelatedRecordsRemote(graph, op, isRemote) {
 	relationship.remoteState = diff.finalState;
 	if (diff.changed) relationship.isDirty = true;
 	relationship._diff = diff;
-	if (relationship.isDirty && !wasDirty) flushCanonical(graph, relationship);
+	if (diff.remoteOrderChanged) flushCanonical(graph, relationship, "remote");
+	if (diff.changed) flushCanonical(graph, relationship, "local");
 }
 function addToInverse(graph, resourceKey, key, value, isRemote) {
 	const relationship = graph.get(resourceKey, key);
@@ -174,11 +175,12 @@ function addToInverse(graph, resourceKey, key, value, isRemote) {
 			graph._addToTransaction(relationship);
 			if (relationship.remoteState !== null) removeFromInverse(graph, relationship.remoteState, relationship.definition.inverseKey, resourceKey, isRemote);
 			relationship.remoteState = value;
+			notifyChange(graph, relationship);
 		}
 		if (relationship.localState !== value) {
 			if (!isRemote && relationship.localState) removeFromInverse(graph, relationship.localState, relationship.definition.inverseKey, resourceKey, isRemote);
 			relationship.localState = value;
-			notifyChange(graph, relationship);
+			if (!isRemote) notifyChange(graph, relationship, "local");
 		}
 	} else if (isHasMany(relationship)) {
 		if (isRemote) {
@@ -195,7 +197,7 @@ function addToInverse(graph, resourceKey, key, value, isRemote) {
 			}
 		} else {
 			if (!relationship.isDirty && !relationship.localState) relationship.localState = [];
-			if (_add(graph, resourceKey, relationship, value, null, isRemote)) notifyChange(graph, relationship);
+			if (_add(graph, resourceKey, relationship, value, null, isRemote)) notifyChange(graph, relationship, "local");
 		}
 	} else if (isRemote) {
 		if (!relationship.remoteMembers.has(value)) {
@@ -215,23 +217,24 @@ function removeFromInverse(graph, resourceKey, key, value, isRemote) {
 		if (isRemote) {
 			graph._addToTransaction(relationship);
 			relationship.remoteState = null;
+			notifyChange(graph, relationship);
 		}
 		if (relationship.localState === value) {
 			relationship.localState = null;
-			notifyChange(graph, relationship);
+			if (!isRemote) notifyChange(graph, relationship, "local");
 		}
 	} else if (isHasMany(relationship)) {
 		if (isRemote) {
 			graph._addToTransaction(relationship);
 			if (_removeRemote(relationship, value)) notifyChange(graph, relationship);
-		} else if (_removeLocal(relationship, value)) notifyChange(graph, relationship);
+		} else if (_removeLocal(relationship, value)) notifyChange(graph, relationship, "local");
 	} else if (isRemote) {
 		relationship.remoteMembers.delete(value);
 		relationship.localMembers.delete(value);
 	} else if (value && relationship.localMembers.has(value)) relationship.localMembers.delete(value);
 }
-function flushCanonical(graph, rel) {
-	if (rel.accessed) graph._scheduleLocalSync(rel);
+function flushCanonical(graph, rel, channel) {
+	if (rel.accessed) graph._scheduleLocalSync(rel, channel);
 }
 
 //#endregion
@@ -270,13 +273,11 @@ function replaceRelatedRecord(graph, op, isRemote = false) {
 		addToInverse(graph, op.value, definition.inverseKey, op.record, isRemote);
 	}
 	if (isRemote) {
+		notifyChange(graph, relationship);
 		const { localState, remoteState } = relationship;
 		if (localState && checkIfNew(graph._realStore, localState) && !remoteState) return;
-		if (localState !== remoteState && localState === existingState) {
-			relationship.localState = remoteState;
-			notifyChange(graph, relationship);
-		}
-	} else notifyChange(graph, relationship);
+		if (localState !== remoteState && localState === existingState) relationship.localState = remoteState;
+	} else notifyChange(graph, relationship, "local");
 }
 
 //#endregion
@@ -845,7 +846,7 @@ function addToRelatedRecords(graph, op, isRemote) {
 	if (!relationship.isDirty && !relationship.localState) relationship.localState = [];
 	if (Array.isArray(value)) for (let i = 0; i < value.length; i++) addRelatedRecord(graph, relationship, record, value[i], index !== void 0 ? index + i : null, isRemote);
 	else addRelatedRecord(graph, relationship, record, value, index ?? null, isRemote);
-	notifyChange(graph, relationship);
+	notifyChange(graph, relationship, isRemote ? void 0 : "local");
 }
 function addRelatedRecord(graph, relationship, record, value, index, isRemote) {
 	if (_add(graph, record, relationship, value, index, isRemote)) addToInverse(graph, value, relationship.definition.inverseKey, record, isRemote);
@@ -872,11 +873,16 @@ function mergeInRelationship(graph, rel, op) {
 	else mergeImplicit(graph, rel, op);
 }
 function mergeBelongsTo(graph, rel, op) {
-	if (rel.remoteState === op.record) rel.remoteState = op.value;
+	let changed = false;
+	if (rel.remoteState === op.record) {
+		rel.remoteState = op.value;
+		changed = true;
+	}
 	if (rel.localState === op.record) {
 		rel.localState = op.value;
-		notifyChange(graph, rel);
+		changed = true;
 	}
+	if (changed) notifyChange(graph, rel);
 }
 function mergeHasMany(graph, rel, op) {
 	if (rel.remoteMembers.has(op.record)) {
@@ -929,7 +935,7 @@ function removeFromRelatedRecords(graph, op, isRemote) {
 	}
 	if (Array.isArray(value)) for (let i = 0; i < value.length; i++) removeRelatedRecord(graph, record, relationship, value[i], op.index ?? null, isRemote);
 	else removeRelatedRecord(graph, record, relationship, value, op.index ?? null, isRemote);
-	notifyChange(graph, relationship);
+	notifyChange(graph, relationship, isRemote ? void 0 : "local");
 }
 function removeRelatedRecord(graph, record, relationship, value, index, isRemote) {
 	if (_remove(graph, record, relationship, value, index, isRemote)) removeFromInverse(graph, value, relationship.definition.inverseKey, record, isRemote);
@@ -1087,8 +1093,11 @@ var Graph = class {
 	* {@link Graph.push} but not yet flushed into the graph by {@link Graph._flushRemoteQueue}.
 	*/
 	/**
-	* The set of {@link CollectionEdge}s that have local changes pending notification, scheduled
-	* via {@link Graph._scheduleLocalSync} and drained by {@link Graph._flushLocalQueue}.
+	* The {@link CollectionEdge}s that have changes pending notification, scheduled via
+	* {@link Graph._scheduleLocalSync} and drained by {@link Graph._flushLocalQueue}, each
+	* mapped to the {@link NotificationChannel} the notification should be scoped to —
+	* `null` when it must reach every subscriber (scheduled unscoped, or scheduled for
+	* both channels).
 	*/
 	/**
 	* The identifier of the current remote-update transaction, or `null` when no transaction is
@@ -1114,7 +1123,7 @@ var Graph = class {
 			hasMany: void 0,
 			deletions: []
 		};
-		this._updatedRelationships = /* @__PURE__ */ new Set();
+		this._updatedRelationships = /* @__PURE__ */ new Map();
 		this._transaction = null;
 		this._removing = null;
 		this.silenceNotifications = false;
@@ -1394,12 +1403,16 @@ var Graph = class {
 		}
 	}
 	/**
-	* Marks a {@link CollectionEdge} as having local changes that need to be notified, and
-	* schedules a flush of the local sync queue (see {@link Graph._flushLocalQueue}) if one is not
-	* already pending.
+	* Marks a {@link CollectionEdge} as having changes that need to be notified on the given
+	* {@link NotificationChannel} (omitted = unscoped, reaching every subscriber), and schedules
+	* a flush of the sync queue (see {@link Graph._flushLocalQueue}) if one is not already
+	* pending. Scheduling the same edge for both channels (or once unscoped) coalesces into a
+	* single unscoped notification.
 	*/
-	_scheduleLocalSync(relationship) {
-		this._updatedRelationships.add(relationship);
+	_scheduleLocalSync(relationship, channel) {
+		const pending = this._updatedRelationships;
+		if (!pending.has(relationship)) pending.set(relationship, channel ?? null);
+		else if (pending.get(relationship) !== (channel ?? null)) pending.set(relationship, null);
 		if (!this._willSyncLocal) {
 			this._willSyncLocal = true;
 			getStore(this.store)._schedule("sync", () => this._flushLocalQueue());
@@ -1443,13 +1456,13 @@ var Graph = class {
 		if (!this._willSyncLocal) return;
 		if (this.silenceNotifications) {
 			this.silenceNotifications = false;
-			this._updatedRelationships = /* @__PURE__ */ new Set();
+			this._updatedRelationships = /* @__PURE__ */ new Map();
 			return;
 		}
 		this._willSyncLocal = false;
 		const updated = this._updatedRelationships;
-		this._updatedRelationships = /* @__PURE__ */ new Set();
-		updated.forEach((rel) => notifyChange(this, rel));
+		this._updatedRelationships = /* @__PURE__ */ new Map();
+		updated.forEach((channel, rel) => notifyChange(this, rel, channel ?? void 0));
 	}
 	/**
 	* Tears down the graph: clears all tracked identifiers/edges, removes it from the global