@ember-data/store 5.4.0-alpha.138 → 5.4.0-alpha.139

package/dist/-private.js

@@ -1 +1 @@
-export { A as ARRAY_SIGNAL, C as CacheHandler, j as CollectionRecordArray, I as LiveArray, M as MUTATE, R as RecordArrayManager, k as SOURCE, S as Store, q as StoreMap, _ as _clearCaches, u as _deprecatingNormalize, g as coerceId, f as constructResource, h as ensureStringId, l as fastPush, i as isStableIdentifier, v as log, w as logGroup, n as notifyArray, p as peekCache, r as recordIdentifierFor, m as removeRecordDataFor, t as setCacheFor, o as setRecordIdentifier, s as storeFor } from "./handler-BWl65Bke.js";
+export { A as ARRAY_SIGNAL, C as CacheHandler, j as CollectionRecordArray, I as LiveArray, M as MUTATE, R as RecordArrayManager, v as RelatedCollection, k as SOURCE, S as Store, q as StoreMap, _ as _clearCaches, u as _deprecatingNormalize, g as coerceId, f as constructResource, h as ensureStringId, l as fastPush, i as isStableIdentifier, w as log, x as logGroup, n as notifyArray, p as peekCache, r as recordIdentifierFor, m as removeRecordDataFor, t as setCacheFor, o as setRecordIdentifier, s as storeFor } from "./many-array-DJ3xLLia.js";

package/dist/index.js

@@ -1,4 +1,4 @@
-export { C as CacheHandler, S as default, r as recordIdentifierFor, c as setIdentifierForgetMethod, a as setIdentifierGenerationMethod, d as setIdentifierResetMethod, b as setIdentifierUpdateMethod, e as setKeyInfoForResource, s as storeFor } from "./handler-BWl65Bke.js";
+export { C as CacheHandler, S as default, r as recordIdentifierFor, c as setIdentifierForgetMethod, a as setIdentifierGenerationMethod, d as setIdentifierResetMethod, b as setIdentifierUpdateMethod, e as setKeyInfoForResource, s as storeFor } from "./many-array-DJ3xLLia.js";
 import '@ember/debug';
 import '@embroider/macros';
 import '@ember-data/request-utils/string';

package/dist/{handler-BWl65Bke.js → many-array-DJ3xLLia.js}

@@ -3,10 +3,10 @@ import { macroCondition, getGlobalConfig, dependencySatisfies, importSync } from
 import { setLogging, getRuntimeConfig } from '@warp-drive/build-config/runtime';
 import { EnableHydration, SkipCache } from '@warp-drive/core-types/request';
 import { getOrSetGlobal, setTransient, peekTransient } from '@warp-drive/core-types/-private';
+import { _backburner } from '@ember/runloop';
+import { defineSignal, createSignal, subscribe, createArrayTags, addToTransaction, addTransactionCB } from '@ember-data/tracking/-private';
 import { CACHE_OWNER, DEBUG_STALE_CACHE_OWNER, DEBUG_CLIENT_ORIGINATED, DEBUG_IDENTIFIER_BUCKET } from '@warp-drive/core-types/identifier';
 import { dasherize } from '@ember-data/request-utils/string';
-import { defineSignal, createSignal, subscribe, createArrayTags, addToTransaction, addTransactionCB } from '@ember-data/tracking/-private';
-import { _backburner } from '@ember/runloop';
 import { compat } from '@ember-data/tracking';
 
 /**
@@ -1847,7 +1847,9 @@ class CacheManager {
   peek(identifier) {
     return this.#cache.peek(identifier);
   }
-
+  peekRemoteState(identifier) {
+    return this.#cache.peekRemoteState(identifier);
+  }
   /**
    * Peek the Cache for the existing request data associated with
    * a cacheable request
@@ -2070,6 +2072,19 @@ class CacheManager {
     return this.#cache.getAttr(identifier, propertyName);
   }
 
+  /**
+   * Retrieve the remote state for an attribute from the cache
+   *
+   * @method getRemoteAttr
+   * @public
+   * @param identifier
+   * @param propertyName
+   * @return {unknown}
+   */
+  getRemoteAttr(identifier, propertyName) {
+    return this.#cache.getRemoteAttr(identifier, propertyName);
+  }
+
   /**
    * Mutate the data for an attribute in the cache
    *
@@ -2194,6 +2209,19 @@ class CacheManager {
     return this.#cache.getRelationship(identifier, propertyName);
   }
 
+  /**
+   * Query the cache for the remote state of a relationship property
+   *
+   * @method getRelationship
+   * @public
+   * @param identifier
+   * @param propertyName
+   * @return resource relationship object
+   */
+  getRemoteRelationship(identifier, propertyName) {
+    return this.#cache.getRemoteRelationship(identifier, propertyName);
+  }
+
   // Resource State
   // ===============
 
@@ -2290,10 +2318,7 @@ function runLoopIsFlushing() {
 function count(label) {
   // @ts-expect-error
   // eslint-disable-next-line
-  globalThis.counts = globalThis.counts || {};
-  // @ts-expect-error
-  // eslint-disable-next-line
-  globalThis.counts[label] = (globalThis.counts[label] || 0) + 1;
+  globalThis.__WarpDriveMetricCountData[label] = (globalThis.__WarpDriveMetricCountData[label] || 0) + 1;
 }
 function _unsubscribe(tokens, token, cache) {
   const identifier = tokens.get(token);
@@ -2827,7 +2852,7 @@ class IdentifierArray {
           return false;
         }
         const original = target[index];
-        const newIdentifier = extractIdentifierFromRecord$1(value);
+        const newIdentifier = extractIdentifierFromRecord$2(value);
         macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
           if (!test) {
             throw new Error(`Expected a record`);
@@ -2868,7 +2893,7 @@ class IdentifierArray {
         return Reflect.deleteProperty(target, prop);
       },
       getPrototypeOf() {
-        return IdentifierArray.prototype;
+        return Array.prototype;
       }
     });
     createArrayTags(proxy, _SIGNAL);
@@ -3011,7 +3036,7 @@ Collection.prototype.query = null;
 // Ensure instanceof works correctly
 // Object.setPrototypeOf(IdentifierArray.prototype, Array.prototype);
 
-function assertRecordPassedToHasMany(record) {
+function assertRecordPassedToHasMany$1(record) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
     if (!test) {
       throw new Error(`All elements of a hasMany relationship must be instances of Model, you passed $${typeof record}`);
@@ -3025,11 +3050,11 @@ function assertRecordPassedToHasMany(record) {
     }
   }()) : {};
 }
-function extractIdentifierFromRecord$1(record) {
+function extractIdentifierFromRecord$2(record) {
   if (!record) {
     return null;
   }
-  assertRecordPassedToHasMany(record);
+  assertRecordPassedToHasMany$1(record);
   return recordIdentifierFor(record);
 }
 
@@ -3124,6 +3149,9 @@ class RecordArrayManager {
     sync(array, pending, this._set.get(array));
     this._pending.delete(array);
   }
+  mutate(mutation) {
+    this.store.cache.mutate(mutation);
+  }
 
   /**
     Get the `RecordArray` for a modelName, which contains all loaded records of
@@ -3645,6 +3673,23 @@ globalThis.setWarpDriveLogging = setLogging;
 
 // @ts-expect-error adding to globalThis
 globalThis.getWarpDriveRuntimeConfig = getRuntimeConfig;
+if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_METRIC_COUNTS)) {
+  if (getGlobalConfig().WarpDrive.debug.LOG_METRIC_COUNTS || globalThis.getWarpDriveRuntimeConfig().debug.LOG_METRIC_COUNTS) {
+    // @ts-expect-error
+    // eslint-disable-next-line
+    globalThis.__WarpDriveMetricCountData = globalThis.__WarpDriveMetricCountData || {};
+    // @ts-expect-error
+    // eslint-disable-next-line
+    globalThis.counts[label] = (globalThis.counts[label] || 0) + 1;
+
+    // @ts-expect-error
+    globalThis.getWarpDriveMetricCounts = () => {
+      // @ts-expect-error
+      // eslint-disable-next-line
+      return globalThis.__WarpDriveMetricCountData;
+    };
+  }
+}
 
 // `AwaitedKeys` is needed here to resolve any promise types like `PromiseBelongsTo`.
 
@@ -4253,9 +4298,8 @@ class Store extends BaseClass {
     This will cause the record to be destroyed and freed up for garbage collection.
      Example
      ```javascript
-    store.findRecord('post', '1').then(function(post) {
-      store.unloadRecord(post);
-    });
+    const { content: { data: post } } = await store.request(findRecord({ type: 'post', id: '1' }));
+    store.unloadRecord(post);
     ```
      @method unloadRecord
     @public
@@ -5539,9 +5583,9 @@ function normalizeProperties(store, identifier, properties) {
           if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
             assertRecordsPassedToHasMany(properties[prop]);
           }
-          properties[prop] = extractIdentifiersFromRecords(properties[prop]);
+          properties[prop] = extractIdentifiersFromRecords$1(properties[prop]);
         } else if (field.kind === 'belongsTo') {
-          properties[prop] = extractIdentifierFromRecord(properties[prop]);
+          properties[prop] = extractIdentifierFromRecord$1(properties[prop]);
         }
       }
     }
@@ -5569,10 +5613,10 @@ function assertRecordsPassedToHasMany(records) {
     });
   }()) : {};
 }
-function extractIdentifiersFromRecords(records) {
-  return records.map(record => extractIdentifierFromRecord(record));
+function extractIdentifiersFromRecords$1(records) {
+  return records.map(record => extractIdentifierFromRecord$1(record));
 }
-function extractIdentifierFromRecord(recordOrPromiseRecord) {
+function extractIdentifierFromRecord$1(recordOrPromiseRecord) {
   if (!recordOrPromiseRecord) {
     return null;
   }
@@ -6220,4 +6264,475 @@ function fetchContentAndHydrate(next, context, identifier, priority) {
     }]
   });
 }
-export { ARRAY_SIGNAL as A, CacheHandler as C, IdentifierArray as I, MUTATE as M, RecordArrayManager as R, Store as S, _clearCaches as _, setIdentifierGenerationMethod as a, setIdentifierUpdateMethod as b, setIdentifierForgetMethod as c, setIdentifierResetMethod as d, setKeyInfoForResource as e, constructResource as f, coerceId as g, ensureStringId as h, isStableIdentifier as i, Collection as j, SOURCE as k, fastPush as l, removeRecordDataFor as m, notifyArray as n, setRecordIdentifier as o, peekCache as p, StoreMap as q, recordIdentifierFor as r, storeFor as s, setCacheFor as t, normalizeModelName as u, log as v, logGroup as w };
+
+/**
+  @module @ember-data/store
+*/
+/**
+  A `ManyArray` is a `MutableArray` that represents the contents of a has-many
+  relationship.
+
+  The `ManyArray` is instantiated lazily the first time the relationship is
+  requested.
+
+  This class is not intended to be directly instantiated by consuming applications.
+
+  ### Inverses
+
+  Often, the relationships in Ember Data applications will have
+  an inverse. For example, imagine the following models are
+  defined:
+
+  ```app/models/post.js
+  import Model, { hasMany } from '@ember-data/model';
+
+  export default class PostModel extends Model {
+    @hasMany('comment') comments;
+  }
+  ```
+
+  ```app/models/comment.js
+  import Model, { belongsTo } from '@ember-data/model';
+
+  export default class CommentModel extends Model {
+    @belongsTo('post') post;
+  }
+  ```
+
+  If you created a new instance of `Post` and added
+  a `Comment` record to its `comments` has-many
+  relationship, you would expect the comment's `post`
+  property to be set to the post that contained
+  the has-many.
+
+  We call the record to which a relationship belongs-to the
+  relationship's _owner_.
+
+  @class ManyArray
+  @public
+*/
+class RelatedCollection extends IdentifierArray {
+  /**
+    The loading state of this array
+     @property {Boolean} isLoaded
+    @public
+    */
+
+  /**
+    `true` if the relationship is polymorphic, `false` otherwise.
+     @property {Boolean} isPolymorphic
+    @private
+    */
+
+  /**
+    Metadata associated with the request for async hasMany relationships.
+     Example
+     Given that the server returns the following JSON payload when fetching a
+    hasMany relationship:
+     ```js
+    {
+      "comments": [{
+        "id": 1,
+        "comment": "This is the first comment",
+      }, {
+    // ...
+      }],
+       "meta": {
+        "page": 1,
+        "total": 5
+      }
+    }
+    ```
+     You can then access the meta data via the `meta` property:
+     ```js
+    let comments = await post.comments;
+    let meta = comments.meta;
+     // meta.page => 1
+    // meta.total => 5
+    ```
+     @property {Object | null} meta
+    @public
+    */
+
+  /**
+     * Retrieve the links for this relationship
+     *
+     @property {Object | null} links
+     @public
+     */
+
+  constructor(options) {
+    super(options);
+    this.isLoaded = options.isLoaded || false;
+    this.isAsync = options.isAsync || false;
+    this.isPolymorphic = options.isPolymorphic || false;
+    this.identifier = options.identifier;
+    this.key = options.key;
+  }
+  [MUTATE](target, receiver, prop, args, _SIGNAL) {
+    switch (prop) {
+      case 'length 0':
+        {
+          Reflect.set(target, 'length', 0);
+          mutateReplaceRelatedRecords(this, [], _SIGNAL);
+          return true;
+        }
+      case 'replace cell':
+        {
+          const [index, prior, value] = args;
+          target[index] = value;
+          mutateReplaceRelatedRecord(this, {
+            value,
+            prior,
+            index
+          }, _SIGNAL);
+          return true;
+        }
+      case 'push':
+        {
+          const newValues = extractIdentifiersFromRecords(args);
+          assertNoDuplicates(this, target, currentState => currentState.push(...newValues), `Cannot push duplicates to a hasMany's state.`);
+          if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_MANY_ARRAY_DUPLICATES)) {
+            // dedupe
+            const seen = new Set(target);
+            const unique = new Set();
+            args.forEach(item => {
+              const identifier = recordIdentifierFor(item);
+              if (!seen.has(identifier)) {
+                seen.add(identifier);
+                unique.add(item);
+              }
+            });
+            const newArgs = Array.from(unique);
+            const result = Reflect.apply(target[prop], receiver, newArgs);
+            if (newArgs.length) {
+              mutateAddToRelatedRecords(this, {
+                value: extractIdentifiersFromRecords(newArgs)
+              }, _SIGNAL);
+            }
+            return result;
+          }
+
+          // else, no dedupe, error on duplicates
+          const result = Reflect.apply(target[prop], receiver, args);
+          if (newValues.length) {
+            mutateAddToRelatedRecords(this, {
+              value: newValues
+            }, _SIGNAL);
+          }
+          return result;
+        }
+      case 'pop':
+        {
+          const result = Reflect.apply(target[prop], receiver, args);
+          if (result) {
+            mutateRemoveFromRelatedRecords(this, {
+              value: recordIdentifierFor(result)
+            }, _SIGNAL);
+          }
+          return result;
+        }
+      case 'unshift':
+        {
+          const newValues = extractIdentifiersFromRecords(args);
+          assertNoDuplicates(this, target, currentState => currentState.unshift(...newValues), `Cannot unshift duplicates to a hasMany's state.`);
+          if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_MANY_ARRAY_DUPLICATES)) {
+            // dedupe
+            const seen = new Set(target);
+            const unique = new Set();
+            args.forEach(item => {
+              const identifier = recordIdentifierFor(item);
+              if (!seen.has(identifier)) {
+                seen.add(identifier);
+                unique.add(item);
+              }
+            });
+            const newArgs = Array.from(unique);
+            const result = Reflect.apply(target[prop], receiver, newArgs);
+            if (newArgs.length) {
+              mutateAddToRelatedRecords(this, {
+                value: extractIdentifiersFromRecords(newArgs),
+                index: 0
+              }, _SIGNAL);
+            }
+            return result;
+          }
+
+          // else, no dedupe, error on duplicates
+          const result = Reflect.apply(target[prop], receiver, args);
+          if (newValues.length) {
+            mutateAddToRelatedRecords(this, {
+              value: newValues,
+              index: 0
+            }, _SIGNAL);
+          }
+          return result;
+        }
+      case 'shift':
+        {
+          const result = Reflect.apply(target[prop], receiver, args);
+          if (result) {
+            mutateRemoveFromRelatedRecords(this, {
+              value: recordIdentifierFor(result),
+              index: 0
+            }, _SIGNAL);
+          }
+          return result;
+        }
+      case 'sort':
+        {
+          const result = Reflect.apply(target[prop], receiver, args);
+          mutateSortRelatedRecords(this, result.map(recordIdentifierFor), _SIGNAL);
+          return result;
+        }
+      case 'splice':
+        {
+          const [start, deleteCount, ...adds] = args;
+
+          // detect a full replace
+          if (start === 0 && deleteCount === this[SOURCE].length) {
+            const newValues = extractIdentifiersFromRecords(adds);
+            assertNoDuplicates(this, target, currentState => currentState.splice(start, deleteCount, ...newValues), `Cannot replace a hasMany's state with a new state that contains duplicates.`);
+            if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_MANY_ARRAY_DUPLICATES)) {
+              // dedupe
+              const current = new Set(adds);
+              const unique = Array.from(current);
+              const newArgs = [start, deleteCount].concat(unique);
+              const result = Reflect.apply(target[prop], receiver, newArgs);
+              mutateReplaceRelatedRecords(this, extractIdentifiersFromRecords(unique), _SIGNAL);
+              return result;
+            }
+
+            // else, no dedupe, error on duplicates
+            const result = Reflect.apply(target[prop], receiver, args);
+            mutateReplaceRelatedRecords(this, newValues, _SIGNAL);
+            return result;
+          }
+          const newValues = extractIdentifiersFromRecords(adds);
+          assertNoDuplicates(this, target, currentState => currentState.splice(start, deleteCount, ...newValues), `Cannot splice a hasMany's state with a new state that contains duplicates.`);
+          if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_MANY_ARRAY_DUPLICATES)) {
+            // dedupe
+            const currentState = target.slice();
+            currentState.splice(start, deleteCount);
+            const seen = new Set(currentState);
+            const unique = [];
+            adds.forEach(item => {
+              const identifier = recordIdentifierFor(item);
+              if (!seen.has(identifier)) {
+                seen.add(identifier);
+                unique.push(item);
+              }
+            });
+            const newArgs = [start, deleteCount, ...unique];
+            const result = Reflect.apply(target[prop], receiver, newArgs);
+            if (deleteCount > 0) {
+              mutateRemoveFromRelatedRecords(this, {
+                value: result.map(recordIdentifierFor),
+                index: start
+              }, _SIGNAL);
+            }
+            if (unique.length > 0) {
+              mutateAddToRelatedRecords(this, {
+                value: extractIdentifiersFromRecords(unique),
+                index: start
+              }, _SIGNAL);
+            }
+            return result;
+          }
+
+          // else, no dedupe, error on duplicates
+          const result = Reflect.apply(target[prop], receiver, args);
+          if (deleteCount > 0) {
+            mutateRemoveFromRelatedRecords(this, {
+              value: result.map(recordIdentifierFor),
+              index: start
+            }, _SIGNAL);
+          }
+          if (newValues.length > 0) {
+            mutateAddToRelatedRecords(this, {
+              value: newValues,
+              index: start
+            }, _SIGNAL);
+          }
+          return result;
+        }
+      default:
+        macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+          {
+            throw new Error(`unable to convert ${prop} into a transaction that updates the cache state for this record array`);
+          }
+        })() : {};
+    }
+  }
+  notify() {
+    const signal = this[ARRAY_SIGNAL];
+    signal.shouldReset = true;
+    notifyArray(this);
+  }
+
+  /**
+    Reloads all of the records in the manyArray. If the manyArray
+    holds a relationship that was originally fetched using a links url
+    EmberData will revisit the original links url to repopulate the
+    relationship.
+     If the ManyArray holds the result of a `store.query()` reload will
+    re-run the original query.
+     Example
+     ```javascript
+    let user = store.peekRecord('user', '1')
+    await login(user);
+     let permissions = await user.permissions;
+    await permissions.reload();
+    ```
+     @method reload
+    @public
+  */
+  reload(options) {
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      if (!test) {
+        throw new Error(`Expected the manager for ManyArray to implement reloadHasMany`);
+      }
+    })(typeof this._manager.reloadHasMany === 'function') : {};
+    // TODO this is odd, we don't ask the store for anything else like this?
+    return this._manager.reloadHasMany(this.key, options);
+  }
+
+  /**
+    Saves all of the records in the `ManyArray`.
+     Note: this API can only be used in legacy mode with a configured Adapter.
+     Example
+     ```javascript
+    const { content: { data: inbox } } = await store.request(findRecord({ type: 'inbox', id: '1' }));
+     let messages = await inbox.messages;
+    messages.forEach((message) => {
+      message.isRead = true;
+    });
+    messages.save();
+    ```
+     @method save
+    @public
+    @return {PromiseArray} promise
+  */
+
+  /**
+    Create a child record within the owner
+     @method createRecord
+    @public
+    @param {Object} hash
+    @return {Model} record
+  */
+  createRecord(hash) {
+    const {
+      store
+    } = this;
+    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+      if (!test) {
+        throw new Error(`Expected modelName to be set`);
+      }
+    })(this.modelName) : {};
+    const record = store.createRecord(this.modelName, hash);
+    this.push(record);
+    return record;
+  }
+  destroy() {
+    super.destroy(false);
+  }
+}
+RelatedCollection.prototype.isAsync = false;
+RelatedCollection.prototype.isPolymorphic = false;
+RelatedCollection.prototype.identifier = null;
+RelatedCollection.prototype.cache = null;
+RelatedCollection.prototype._inverseIsAsync = false;
+RelatedCollection.prototype.key = '';
+RelatedCollection.prototype.DEPRECATED_CLASS_NAME = 'ManyArray';
+function assertRecordPassedToHasMany(record) {
+  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+    if (!test) {
+      throw new Error(`All elements of a hasMany relationship must be instances of Model, you passed ${typeof record}`);
+    }
+  })(function () {
+    try {
+      recordIdentifierFor(record);
+      return true;
+    } catch {
+      return false;
+    }
+  }()) : {};
+}
+function extractIdentifiersFromRecords(records) {
+  return records.map(extractIdentifierFromRecord);
+}
+function extractIdentifierFromRecord(recordOrPromiseRecord) {
+  assertRecordPassedToHasMany(recordOrPromiseRecord);
+  return recordIdentifierFor(recordOrPromiseRecord);
+}
+function assertNoDuplicates(collection, target, callback, reason) {
+  const state = target.slice();
+  callback(state);
+  if (state.length !== new Set(state).size) {
+    const duplicates = state.filter((currentValue, currentIndex) => state.indexOf(currentValue) !== currentIndex);
+    if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_MANY_ARRAY_DUPLICATES)) {
+      deprecate(`${reason} This behavior is deprecated. Found duplicates for the following records within the new state provided to \`<${collection.identifier.type}:${collection.identifier.id || collection.identifier.lid}>.${collection.key}\`\n\t- ${Array.from(new Set(duplicates)).map(r => isStableIdentifier(r) ? r.lid : recordIdentifierFor(r).lid).sort((a, b) => a.localeCompare(b)).join('\n\t- ')}`, false, {
+        id: 'ember-data:deprecate-many-array-duplicates',
+        for: 'ember-data',
+        until: '6.0',
+        since: {
+          enabled: '5.3',
+          available: '4.13'
+        }
+      });
+    } else {
+      throw new Error(`${reason} Found duplicates for the following records within the new state provided to \`<${collection.identifier.type}:${collection.identifier.id || collection.identifier.lid}>.${collection.key}\`\n\t- ${Array.from(new Set(duplicates)).map(r => isStableIdentifier(r) ? r.lid : recordIdentifierFor(r).lid).sort((a, b) => a.localeCompare(b)).join('\n\t- ')}`);
+    }
+  }
+}
+function mutateAddToRelatedRecords(collection, operationInfo, _SIGNAL) {
+  mutate(collection, {
+    op: 'addToRelatedRecords',
+    record: collection.identifier,
+    field: collection.key,
+    ...operationInfo
+  }, _SIGNAL);
+}
+function mutateRemoveFromRelatedRecords(collection, operationInfo, _SIGNAL) {
+  mutate(collection, {
+    op: 'removeFromRelatedRecords',
+    record: collection.identifier,
+    field: collection.key,
+    ...operationInfo
+  }, _SIGNAL);
+}
+function mutateReplaceRelatedRecord(collection, operationInfo, _SIGNAL) {
+  mutate(collection, {
+    op: 'replaceRelatedRecord',
+    record: collection.identifier,
+    field: collection.key,
+    ...operationInfo
+  }, _SIGNAL);
+}
+function mutateReplaceRelatedRecords(collection, value, _SIGNAL) {
+  mutate(collection, {
+    op: 'replaceRelatedRecords',
+    record: collection.identifier,
+    field: collection.key,
+    value
+  }, _SIGNAL);
+}
+function mutateSortRelatedRecords(collection, value, _SIGNAL) {
+  mutate(collection, {
+    op: 'sortRelatedRecords',
+    record: collection.identifier,
+    field: collection.key,
+    value
+  }, _SIGNAL);
+}
+function mutate(collection, mutation, _SIGNAL) {
+  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
+    if (!test) {
+      throw new Error(`Expected the manager for ManyArray to implement mutate`);
+    }
+  })(typeof collection._manager.mutate === 'function') : {};
+  collection._manager.mutate(mutation);
+  addToTransaction(_SIGNAL);
+}
+export { ARRAY_SIGNAL as A, CacheHandler as C, IdentifierArray as I, MUTATE as M, RecordArrayManager as R, Store as S, _clearCaches as _, setIdentifierGenerationMethod as a, setIdentifierUpdateMethod as b, setIdentifierForgetMethod as c, setIdentifierResetMethod as d, setKeyInfoForResource as e, constructResource as f, coerceId as g, ensureStringId as h, isStableIdentifier as i, Collection as j, SOURCE as k, fastPush as l, removeRecordDataFor as m, notifyArray as n, setRecordIdentifier as o, peekCache as p, StoreMap as q, recordIdentifierFor as r, storeFor as s, setCacheFor as t, normalizeModelName as u, RelatedCollection as v, log as w, logGroup as x };