@warp-drive-mirror/core 5.10.0-alpha.2 → 5.10.0-alpha.21

package/dist/graph/-private.js

@@ -1,8 +1,8 @@
-import { a as setTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-CWh7qdp_.js";
+import { getOrSetGlobal, peekTransient, setTransient } from "../types/-private.js";
 import { getGlobalConfig, macroCondition } from "@embroider/macros";
 import { deprecate, warn } from "@ember/debug";
 
-//#region src/graph/-private/coerce-id.ts
+// src/graph/-private/coerce-id.ts
 function coerceId(id) {
 	if (macroCondition(getGlobalConfig().WarpDriveMirror.deprecations.DEPRECATE_NON_STRICT_ID)) {
 		let normalized;
@@ -25,8 +25,7 @@ function coerceId(id) {
 	return id;
 }
 
-//#endregion
-//#region src/graph/-private/-utils.ts
+// src/graph/-private/-utils.ts
 /** Retrieves the private {@link Store} instance from a capabilities manager (or any object exposing `_store`). */
 function getStore(wrapper) {
 	macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) && ((test) => {
@@ -57,9 +56,9 @@ function assertValidRelationshipPayload(graph, op) {
 	const { definition, identifier, state } = relationship;
 	const { type } = identifier;
 	const { field } = op;
-	const { isAsync, kind } = definition;
+	const { isAsync, isLinksMode, kind } = definition;
 	if (payload.links) {
-		if (macroCondition(!getGlobalConfig().WarpDriveMirror.features.JSON_API_CACHE_VALIDATION_ERRORS)) warn(`You pushed a record of type '${type}' with a relationship '${field}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, isAsync || payload.data === null || !!payload.data || state.hasReceivedData, { id: "ds.store.push-link-for-sync-relationship" });
+		if (macroCondition(!getGlobalConfig().WarpDriveMirror.features.JSON_API_CACHE_VALIDATION_ERRORS)) warn(`You pushed a record of type '${type}' with a relationship '${field}' configured as 'async: false'. You've included a link but no primary data, this may be an error in your payload. WarpDrive will treat this relationship as known-to-be-empty.`, isAsync || isLinksMode || payload.data === null || !!payload.data || state.hasReceivedData, { id: "ds.store.push-link-for-sync-relationship" });
 	} else if (payload.data) {
 		if (kind === "belongsTo") {
 			macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) && ((test) => {
@@ -190,8 +189,7 @@ function assertRelationshipData(store, resourceKey, data, meta) {
 	})(data === null || !data.type || store.schema.hasResource(data));
 }
 
-//#endregion
-//#region src/graph/-private/-edge-definition.ts
+// src/graph/-private/-edge-definition.ts
 const RELATIONSHIP_KINDS = [
 	"belongsTo",
 	"hasMany",
@@ -391,7 +389,7 @@ function upgradeDefinition(graph, key, propertyName, isImplicit = false) {
 		})(storeWrapper.schema.hasResource({ type: inverseType }));
 		inverseDefinition = null;
 	} else {
-		inverseKey = inverseForRelationship(getStore(storeWrapper), key, propertyName);
+		inverseKey = inverseForRelationship(getStore(storeWrapper), key, meta.name);
 		if (!inverseKey && definition.isPolymorphic && definition.inverseKey) inverseDefinition = {
 			kind: "belongsTo",
 			key: definition.inverseKey,
@@ -416,6 +414,7 @@ function upgradeDefinition(graph, key, propertyName, isImplicit = false) {
 				if (!test) throw new Error(`Expected ${inverseKey} to be a relationship`);
 			})(isRelationshipField(metaFromInverse));
 			inverseDefinition = upgradeMeta(metaFromInverse);
+			inverseKey = inverseDefinition.key;
 		}
 	}
 	if (!inverseDefinition) {
@@ -510,8 +509,7 @@ function inverseForRelationship(store, resourceKey, key) {
 	return definition.options.inverse;
 }
 
-//#endregion
-//#region src/graph/-private/debug/assert-polymorphic-type.ts
+// src/graph/-private/debug/assert-polymorphic-type.ts
 let assertPolymorphicType;
 let assertInheritedSchema;
 if (macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG)) {
@@ -645,8 +643,7 @@ if (macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG)) {
 	};
 }
 
-//#endregion
-//#region src/graph/-private/operations/replace-related-records.ts
+// src/graph/-private/operations/replace-related-records.ts
 function count(label) {
 	globalThis.__WarpDriveMetricCountData[label] = (globalThis.__WarpDriveMetricCountData[label] || 0) + 1;
 }
@@ -867,8 +864,7 @@ function flushCanonical(graph, rel, channel) {
 	if (rel.accessed) graph._scheduleLocalSync(rel, channel);
 }
 
-//#endregion
-//#region src/graph/-private/operations/replace-related-record.ts
+// src/graph/-private/operations/replace-related-record.ts
 function replaceRelatedRecord(graph, op, isRemote = false) {
 	const relationship = graph.get(op.record, op.field);
 	macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) && ((test) => {
@@ -947,8 +943,7 @@ function replaceRelatedRecord(graph, op, isRemote = false) {
 	} else notifyChange(graph, relationship, "local");
 }
 
-//#endregion
-//#region src/graph/-private/-diff.ts
+// src/graph/-private/-diff.ts
 function _deprecatedCompare(priorLocalState, newState, newMembers, prevState, prevSet, onAdd, onDel, remoteClearsLocal) {
 	const newLength = newState.length;
 	const prevLength = prevState.length;
@@ -1306,8 +1301,7 @@ function rollbackRelationship(graph, key, field, relationship) {
 	}
 }
 
-//#endregion
-//#region src/graph/-private/-state.ts
+// src/graph/-private/-state.ts
 function createState() {
 	if (macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG)) {
 		if (macroCondition(getGlobalConfig().WarpDriveMirror.activeLogging.LOG_GRAPH)) {
@@ -1341,8 +1335,7 @@ function createState() {
 	};
 }
 
-//#endregion
-//#region src/graph/-private/edges/collection.ts
+// src/graph/-private/edges/collection.ts
 /**
 * Stores the graph's internal state for one side of a collection (`hasMany`) relationship.
 */
@@ -1379,8 +1372,7 @@ function legacyGetCollectionRelationshipData(source, getRemoteState) {
 	return payload;
 }
 
-//#endregion
-//#region src/graph/-private/edges/implicit.ts
+// src/graph/-private/edges/implicit.ts
 /**
 * The relationship definition (schema metadata) backing an {@link ImplicitEdge}, tagging
 * the {@link UpgradedMeta} as belonging to an implicit inverse relationship.
@@ -1425,8 +1417,7 @@ function createImplicitEdge(definition, identifier) {
 	};
 }
 
-//#endregion
-//#region src/graph/-private/edges/resource.ts
+// src/graph/-private/edges/resource.ts
 function createResourceEdge(definition, identifier) {
 	return {
 		definition,
@@ -1452,8 +1443,7 @@ function legacyGetResourceRelationshipData(source, getRemoteState) {
 	return payload;
 }
 
-//#endregion
-//#region src/graph/-private/operations/add-to-related-records.ts
+// src/graph/-private/operations/add-to-related-records.ts
 function addToRelatedRecords(graph, op, isRemote) {
 	const { record, value, index } = op;
 	const relationship = graph.get(record, op.field);
@@ -1488,8 +1478,7 @@ function addRelatedRecord(graph, relationship, record, value, index, isRemote) {
 	if (_add(graph, record, relationship, value, index, isRemote)) addToInverse(graph, value, relationship.definition.inverseKey, record, isRemote);
 }
 
-//#endregion
-//#region src/graph/-private/operations/merge-identifier.ts
+// src/graph/-private/operations/merge-identifier.ts
 function mergeIdentifier(graph, op, relationships) {
 	Object.keys(relationships).forEach((key) => {
 		const rel = relationships[key];
@@ -1551,8 +1540,7 @@ function mergeImplicit(graph, rel, op) {
 	}
 }
 
-//#endregion
-//#region src/graph/-private/operations/remove-from-related-records.ts
+// src/graph/-private/operations/remove-from-related-records.ts
 function removeFromRelatedRecords(graph, op, isRemote) {
 	const { record, value } = op;
 	const relationship = graph.get(record, op.field);
@@ -1586,8 +1574,7 @@ function removeRelatedRecord(graph, record, relationship, value, index, isRemote
 	if (_remove(graph, record, relationship, value, index, isRemote)) removeFromInverse(graph, value, relationship.definition.inverseKey, record, isRemote);
 }
 
-//#endregion
-//#region src/graph/-private/normalize-link.ts
+// src/graph/-private/normalize-link.ts
 function _normalizeLink(link) {
 	switch (typeof link) {
 		case "object": return link;
@@ -1595,8 +1582,7 @@ function _normalizeLink(link) {
 	}
 }
 
-//#endregion
-//#region src/graph/-private/operations/update-relationship.ts
+// src/graph/-private/operations/update-relationship.ts
 function updateRelationshipOperation(graph, op) {
 	const relationship = graph.get(op.record, op.field);
 	macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG) && ((test) => {
@@ -1667,8 +1653,7 @@ function upgradeIdentifiers(arr, cache) {
 	return arr;
 }
 
-//#endregion
-//#region src/graph/-private/graph.ts
+// src/graph/-private/graph.ts
 /**
 * A single edge (relationship field) tracked by the {@link Graph} for a resource. Which kind of edge
 * a field is depends on its relationship definition:
@@ -2337,8 +2322,7 @@ function isReordered(relationship) {
 	return false;
 }
 
-//#endregion
-//#region src/graph/-private.ts
+// src/graph/-private.ts
 /**
 Provides a performance tuned normalized graph for intelligently managing relationships between resources based on identity
 
@@ -2346,6 +2330,8 @@ While this Graph is abstract, it currently is a private implementation required
 
 We intend to make this Graph public API after some additional iteration during the 5.x timeframe, until then all APIs should be considered experimental and unstable, not fit for direct application or 3rd party library usage.
 
+@summary Experimental, private relationship graph used by the {json:api} Cache to track links between resources
+by identity.
 @module
 */
 function isStore(maybeStore) {
@@ -2374,6 +2360,5 @@ function graphFor(store) {
 	return graph;
 }
 
-//#endregion
 export { graphFor, isBelongsTo, peekGraph };
 //# sourceMappingURL=-private.js.map