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

package/dist/unpkg/dev-deprecated/graph/-private.js

@@ -1,5 +1,5 @@
-import { a as setTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-2RfQ2761.js";
-import { t as getGlobalConfig } from "../runtime-BacZMq1r.js";
+import { a as setTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-DhiS6yOR.js";
+import { t as getGlobalConfig } from "../runtime-CPL2BGgT.js";
 
 //#region src/graph/-private/coerce-id.ts
 function coerceId(id) {
@@ -138,7 +138,7 @@ 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;
@@ -147,7 +147,7 @@ function notifyChange(graph, relationship) {
 		return;
 	}
 	if (getGlobalConfig().WarpDrive.debug.LOG_GRAPH || globalThis.getWarpDriveRuntimeConfig().debug.LOG_GRAPH) console.log(`Graph: notifying relationship change for ${String(resourceKey)} ${key}`);
-	graph.store.notifyChange(resourceKey, "relationships", key);
+	graph.store.notifyChange(resourceKey, "relationships", key, channel);
 }
 /**
 * Asserts (dev-only) that a pushed relationship data payload conforms to the JSON:API resource
@@ -685,7 +685,7 @@ 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;
@@ -750,7 +750,8 @@ function replaceRelatedRecordsRemote(graph, op, isRemote) {
 		}
 		if (deprecationInfo.triggered) console.warn(`WarpDrive is changing the default semantics of updates to the remote state of relationships.\n\nThe following local state was cleared from the <${relationship.identifier.type}>.${relationship.definition.key} hasMany relationship but will not be once this deprecation is resolved by opting into the new behavior:\n\n\tAdded: [${deprecationInfo.additions.map((i) => i.lid).join(", ")}]\n\tRemoved: [${deprecationInfo.removals.map((i) => i.lid).join(", ")}]`);
 	}
-	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);
@@ -766,11 +767,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) {
@@ -787,7 +789,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)) {
@@ -807,23 +809,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
@@ -847,7 +850,7 @@ function replaceRelatedRecord(graph, op, isRemote = false) {
 			else if (localState !== op.value && relationship.definition.resetOnRemoteUpdate !== false) {
 				relationship.localState = existingState;
 				console.warn(`WarpDrive is changing the default semantics of updates to the remote state of relationships.\n\nThe following local state was cleared from the <${relationship.identifier.type}>.${relationship.definition.key} belongsTo relationship but will not be once this deprecation is resolved:\n\n\t${localState ? "Added: " + localState.lid + "\n	" : ""}${existingState ? "Removed: " + existingState.lid : ""}`);
-				notifyChange(graph, relationship);
+				notifyChange(graph, relationship, "local");
 			}
 		}
 		return;
@@ -873,17 +876,15 @@ 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 if (localState !== remoteState && localState !== existingState && relationship.definition.resetOnRemoteUpdate !== false) {
+		if (localState !== remoteState && localState === existingState) relationship.localState = remoteState;
+		else if (localState !== remoteState && localState !== existingState && relationship.definition.resetOnRemoteUpdate !== false) {
 			relationship.localState = remoteState;
 			console.warn(`WarpDrive is changing the default semantics of updates to the remote state of relationships.\n\nThe following local state was cleared from the <${relationship.identifier.type}>.${relationship.definition.key} belongsTo relationship but will not be once this deprecation is resolved:\n\n\t${localState ? "Added: " + localState.lid + "\n	" : ""}${existingState ? "Removed: " + existingState.lid : ""}`);
-			notifyChange(graph, relationship);
 		}
-	} else notifyChange(graph, relationship);
+	} else notifyChange(graph, relationship, "local");
 }
 
 //#endregion
@@ -1380,7 +1381,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) {
 	((test) => {
@@ -1410,11 +1411,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)) {
@@ -1473,7 +1479,7 @@ function removeFromRelatedRecords(graph, op, isRemote) {
 	})(isHasMany(relationship));
 	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) {
 	((test) => {
@@ -1645,8 +1651,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
@@ -1672,7 +1681,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;
@@ -2004,12 +2013,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());
@@ -2062,13 +2075,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