@ember-data/store 5.6.0-alpha.2 → 5.6.0-alpha.4

package/dist/{request-state-uRtpn0Lc.js → request-state-BEsHKec0.js}

@@ -1,17 +1,12 @@
 import { deprecate, warn } from '@ember/debug';
 import { macroCondition, getGlobalConfig, dependencySatisfies, importSync } from '@embroider/macros';
-import { EnableHydration, SkipCache } from '@warp-drive/core-types/request';
+import { withBrand, EnableHydration, SkipCache } from '@warp-drive/core-types/request';
 import { setLogging, getRuntimeConfig } from '@warp-drive/core-types/runtime';
 import { getOrSetGlobal, peekTransient, setTransient } from '@warp-drive/core-types/-private';
-import { a as createSignal, b as consumeSignal, n as notifySignal, c as createMemo, w as willSyncFlushWatchers, A as ARRAY_SIGNAL } from "./configure-BfLLW6GY.js";
+import { a as createSignal, b as consumeSignal, n as notifySignal, c as createMemo, w as willSyncFlushWatchers, A as ARRAY_SIGNAL } from "./configure-BCr2QDik.js";
 import { CACHE_OWNER, DEBUG_STALE_CACHE_OWNER, DEBUG_IDENTIFIER_BUCKET, DEBUG_CLIENT_ORIGINATED } from '@warp-drive/core-types/identifier';
 import { dasherize } from '@ember-data/request-utils/string';
 import { getPromiseResult, setPromiseResult } from '@ember-data/request';
-
-/**
-  @module @ember-data/store
-*/
-
 function coerceId(id) {
   if (macroCondition(getGlobalConfig().WarpDrive.deprecations.DEPRECATE_NON_STRICT_ID)) {
     let normalized;
@@ -68,11 +63,6 @@ function normalizeModelName(type) {
   }
   return type;
 }
-
-/**
-  @module @ember-data/store
-*/
-
 function installPolyfill() {
   const isFastBoot = typeof FastBoot !== 'undefined';
   const CRYPTO = isFastBoot ? FastBoot.require('crypto') : globalThis.crypto;
@@ -125,10 +115,6 @@ function hasId(resource) {
 function hasType(resource) {
   return hasProp(resource, 'type');
 }
-
-/**
-  @module @ember-data/store
-*/
 const DOCUMENTS = getOrSetGlobal('DOCUMENTS', new Set());
 function isStableIdentifier(identifier) {
   return identifier[CACHE_OWNER] !== undefined;
@@ -293,7 +279,6 @@ class IdentifierCache {
    * we allow late binding of this private internal merge so that
    * the cache can insert itself here to handle elimination of duplicates
    *
-   * @method __configureMerge
    * @private
    */
   __configureMerge(method) {
@@ -304,7 +289,6 @@ class IdentifierCache {
   }
 
   /**
-   * @method _getRecordIdentifier
    * @private
    */
 
@@ -389,7 +373,6 @@ class IdentifierCache {
    * useful for the "create" case when we need to see if
    * we are accidentally overwritting something
    *
-   * @method peekRecordIdentifier
    * @param resource
    * @return {StableRecordIdentifier | undefined}
    * @private
@@ -401,8 +384,7 @@ class IdentifierCache {
   /**
     Returns the DocumentIdentifier for the given Request, creates one if it does not yet exist.
     Returns `null` if the request does not have a `cacheKey` or `url`.
-     @method getOrCreateDocumentIdentifier
-    @param request
+     @param request
     @return {StableDocumentIdentifier | null}
     @public
   */
@@ -435,8 +417,7 @@ class IdentifierCache {
     - return an object with an `lid` that is stable (repeated calls with the same
       `id` + `type` or `lid` will return the same `lid` value)
     - this referential stability of the object itself is guaranteed
-     @method getOrCreateRecordIdentifier
-    @param resource
+     @param resource
     @return {StableRecordIdentifier}
     @public
   */
@@ -450,8 +431,7 @@ class IdentifierCache {
    potentially does not have an `id`.
     Delegates generation to the user supplied `GenerateMethod` if one has been provided
    with the signature `generateMethod({ type }, 'record')`.
-    @method createIdentifierForNewRecord
-   @param data
+    @param data
    @return {StableRecordIdentifier}
    @public
   */
@@ -494,8 +474,7 @@ class IdentifierCache {
      If a merge occurs, it is possible the returned identifier does not match the originally
     provided identifier. In this case the abandoned identifier will go through the usual
     `forgetRecordIdentifier` codepaths.
-     @method updateRecordIdentifier
-    @param identifierObject
+     @param identifierObject
     @param data
     @return {StableRecordIdentifier}
     @public
@@ -564,7 +543,6 @@ class IdentifierCache {
   }
 
   /**
-   * @method _mergeRecordIdentifiers
    * @private
    */
   _mergeRecordIdentifiers(keyInfo, identifier, existingIdentifier, data) {
@@ -612,8 +590,7 @@ class IdentifierCache {
     Useful when a record has been deleted and the deletion has been persisted and
    we do not care about the record anymore. Especially useful when an `id` of a
    deleted record might be reused later for a new record.
-    @method forgetRecordIdentifier
-   @param identifierObject
+    @param identifierObject
    @public
   */
   forgetRecordIdentifier(identifierObject) {
@@ -1135,11 +1112,6 @@ function defineGate(obj, key, desc) {
   }, gate(obj, key, desc));
   Object.defineProperty(obj, key, options);
 }
-
-/**
- * @module @ember-data/store
- */
-
 function urlFromLink(link) {
   if (typeof link === 'string') return link;
   return link.href;
@@ -1235,7 +1207,10 @@ class ReactiveDocument {
       });
     }
   }
-  async #request(link, options) {
+  async #request(link, options = withBrand({
+    url: '',
+    method: 'GET'
+  })) {
     const href = this.links?.[link];
     if (!href) {
       return null;
@@ -1253,12 +1228,14 @@ class ReactiveDocument {
    * with the document when the request completes. If no related link is present,
    * will fallback to the self link if present
    *
-   * @method fetch
    * @public
    * @param {Object} options
-   * @return Promise<Document>
+   * @return {Promise<Document>}
    */
-  fetch(options = {}) {
+  fetch(options = withBrand({
+    url: '',
+    method: 'GET'
+  })) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
       if (!test) {
         throw new Error(`No self or related link`);
@@ -1274,12 +1251,11 @@ class ReactiveDocument {
    * with the new document when the request completes, or null  if there is no
    * next link.
    *
-   * @method next
    * @public
    * @param {Object} options
-   * @return Promise<Document | null>
+   * @return {Promise<Document | null>}
    */
-  next(options = {}) {
+  next(options) {
     return this.#request('next', options);
   }
 
@@ -1288,12 +1264,11 @@ class ReactiveDocument {
    * with the new document when the request completes, or null if there is no
    * prev link.
    *
-   * @method prev
    * @public
    * @param {Object} options
-   * @return Promise<Document | null>
+   * @return {Promise<Document | null>}
    */
-  prev(options = {}) {
+  prev(options) {
     return this.#request('prev', options);
   }
 
@@ -1302,12 +1277,11 @@ class ReactiveDocument {
    * with the new document when the request completes, or null if there is no
    * first link.
    *
-   * @method first
    * @public
    * @param {Object} options
-   * @return Promise<Document | null>
+   * @return {Promise<Document | null>}
    */
-  first(options = {}) {
+  first(options) {
     return this.#request('first', options);
   }
 
@@ -1316,12 +1290,11 @@ class ReactiveDocument {
    * with the new document when the request completes, or null if there is no
    * last link.
    *
-   * @method last
    * @public
    * @param {Object} options
-   * @return Promise<Document | null>
+   * @return {Promise<Document | null>}
    */
-  last(options = {}) {
+  last(options) {
     return this.#request('last', options);
   }
 
@@ -1334,7 +1307,6 @@ class ReactiveDocument {
    * the document's contents, leaving that to the individual record
    * instances to determine how to do, if at all.
    *
-   * @method toJSON
    * @public
    * @return
    */
@@ -1441,14 +1413,6 @@ defineGate(ReactiveDocument.prototype, 'meta', {
   }
 });
 
-/**
-  @module @ember-data/store
-*/
-
-/**
-  @module @ember-data/store
-*/
-
 /**
    A `RecordReference` is a low-level API that allows users and
    addon authors to perform meta-operations on a record.
@@ -1485,8 +1449,7 @@ class RecordReference {
      let userRef = store.getReference('user', 1);
       userRef.id(); // '1'
      ```
-      @method id
-    @public
+     @public
      @return {String} The id of the record.
   */
   id() {
@@ -1504,8 +1467,7 @@ class RecordReference {
      let userRef = store.getReference('user', 1);
       userRef.identifier(); // '1'
      ```
-      @method identifier
-    @public
+     @public
      @return {String} The identifier of the record.
   */
   identifier() {
@@ -1521,8 +1483,7 @@ class RecordReference {
      const userRef = store.getReference('user', 1);
       userRef.remoteType(); // 'identity'
      ```
-      @method remoteType
-     @public
+      @public
      @return {String} 'identity'
   */
   remoteType() {
@@ -1557,8 +1518,7 @@ class RecordReference {
        userRef.value() === user;
      });
      ```
-     @method push
-    @public
+     @public
     @param objectOrPromise a JSON:API ResourceDocument or a promise resolving to one
     @return a promise for the value (record or relationship)
   */
@@ -1578,8 +1538,7 @@ class RecordReference {
      let userRef = store.getReference('user', 1);
       userRef.value(); // user
      ```
-      @method value
-    @public
+     @public
      @return {Model} the record for this RecordReference
   */
   value() {
@@ -1595,8 +1554,7 @@ class RecordReference {
       // load user (via store.find)
      userRef.load().then(...)
      ```
-      @method load
-    @public
+     @public
      @return {Promise<record>} the record for this RecordReference
   */
   load() {
@@ -1620,8 +1578,7 @@ class RecordReference {
       // or trigger a reload
      userRef.reload().then(...)
      ```
-      @method reload
-    @public
+     @public
      @return {Promise<record>} the record for this RecordReference
   */
   reload() {
@@ -1639,10 +1596,6 @@ class RecordReference {
   }
 }
 defineSignal(RecordReference.prototype, '_ref');
-
-/**
-  @module @ember-data/store
-*/
 class CacheCapabilitiesManager {
   constructor(_store) {
     this._store = _store;
@@ -1759,11 +1712,6 @@ function peekCache(instance) {
 function isDestroyable(record) {
   return Boolean(record && typeof record === 'object' && typeof record.destroy === 'function');
 }
-
-/**
-  @module @ember-data/store
-*/
-
 const RecordCache = getOrSetGlobal('RecordCache', new Map());
 function peekRecordIdentifier(record) {
   return RecordCache.get(record);
@@ -1772,6 +1720,7 @@ function peekRecordIdentifier(record) {
 /**
   Retrieves the unique referentially-stable [RecordIdentifier](/ember-data/release/classes/StableRecordIdentifier)
   assigned to the given record instance.
+
   ```js
   import { recordIdentifierFor } from "@ember-data/store";
   // ... gain access to a record, for instance with peekRecord or findRecord
@@ -1781,10 +1730,8 @@ function peekRecordIdentifier(record) {
   // access the identifier's properties.
   const { id, type, lid } = identifier;
   ```
-  @method recordIdentifierFor
+
   @public
-  @static
-  @for @ember-data/store
   @param {Object} record a record instance previously obstained from the store.
   @return {StableRecordIdentifier}
  */
@@ -2330,7 +2277,6 @@ class CacheManager {
    * a `content` member and therefor must not assume the existence
    * of `request` and `response` on the document.
    *
-   * @method put
    * @param {StructuredDocument} doc
    * @return {ResourceDocument}
    * @public
@@ -2345,7 +2291,6 @@ class CacheManager {
    * Note: currently the only valid operation is a MergeOperation
    * which occurs when a collision of identifiers is detected.
    *
-   * @method patch
    * @public
    * @param op the operation to perform
    * @return {void}
@@ -2358,7 +2303,6 @@ class CacheManager {
    * Update resource data with a local mutation. Currently supports operations
    * on relationships only.
    *
-   * @method mutate
    * @public
    * @param mutation
    */
@@ -2393,7 +2337,6 @@ class CacheManager {
    * of the Graph handling necessary entanglements and
    * notifications for relational data.
    *
-   * @method peek
    * @public
    * @param {StableRecordIdentifier | StableDocumentIdentifier} identifier
    * @return {ResourceDocument | ResourceBlob | null} the known resource data
@@ -2409,7 +2352,6 @@ class CacheManager {
    * Peek the Cache for the existing request data associated with
    * a cacheable request
    *
-   * @method peekRequest
    * @param {StableDocumentIdentifier}
    * @return {StableDocumentIdentifier | null}
    * @public
@@ -2421,7 +2363,6 @@ class CacheManager {
   /**
    * Push resource data from a remote source into the cache for this identifier
    *
-   * @method upsert
    * @public
    * @param identifier
    * @param data
@@ -2442,9 +2383,8 @@ class CacheManager {
    * preferring instead to fork at the Store level, which will
    * utilize this method to fork the cache.
    *
-   * @method fork
    * @public
-   * @return Promise<Cache>
+   * @return {Promise<Cache>}
    */
   fork() {
     return this.#cache.fork();
@@ -2457,10 +2397,9 @@ class CacheManager {
    * preferring instead to merge at the Store level, which will
    * utilize this method to merge the caches.
    *
-   * @method merge
    * @param {Cache} cache
    * @public
-   * @return Promise<void>
+   * @return {Promise<void>}
    */
   merge(cache) {
     return this.#cache.merge(cache);
@@ -2496,7 +2435,6 @@ class CacheManager {
    * }
    * ```
    *
-   * @method diff
    * @public
    */
   diff() {
@@ -2511,7 +2449,6 @@ class CacheManager {
    * which may be fed back into a new instance of the same Cache
    * via `cache.hydrate`.
    *
-   * @method dump
    * @return {Promise<ReadableStream>}
    * @public
    */
@@ -2531,7 +2468,6 @@ class CacheManager {
    * behavior supports optimizing pre/fetching of data for route transitions
    * via data-only SSR modes.
    *
-   * @method hydrate
    * @param {ReadableStream} stream
    * @return {Promise<void>}
    * @public
@@ -2552,7 +2488,6 @@ class CacheManager {
    * It returns properties from options that should be set on the record during the create
    * process. This return value behavior is deprecated.
    *
-   * @method clientDidCreate
    * @public
    * @param identifier
    * @param options
@@ -2565,7 +2500,6 @@ class CacheManager {
    * [LIFECYCLE] Signals to the cache that a resource
    * will be part of a save transaction.
    *
-   * @method willCommit
    * @public
    * @param identifier
    */
@@ -2577,7 +2511,6 @@ class CacheManager {
    * [LIFECYCLE] Signals to the cache that a resource
    * was successfully updated as part of a save transaction.
    *
-   * @method didCommit
    * @public
    * @param identifier
    * @param data
@@ -2590,7 +2523,6 @@ class CacheManager {
    * [LIFECYCLE] Signals to the cache that a resource
    * was update via a save transaction failed.
    *
-   * @method commitWasRejected
    * @public
    * @param identifier
    * @param errors
@@ -2603,7 +2535,6 @@ class CacheManager {
    * [LIFECYCLE] Signals to the cache that all data for a resource
    * should be cleared.
    *
-   * @method unloadRecord
    * @public
    * @param identifier
    */
@@ -2617,7 +2548,6 @@ class CacheManager {
   /**
    * Retrieve the data for an attribute from the cache
    *
-   * @method getAttr
    * @public
    * @param identifier
    * @param propertyName
@@ -2630,7 +2560,6 @@ class CacheManager {
   /**
    * Retrieve the remote state for an attribute from the cache
    *
-   * @method getRemoteAttr
    * @public
    * @param identifier
    * @param propertyName
@@ -2643,7 +2572,6 @@ class CacheManager {
   /**
    * Mutate the data for an attribute in the cache
    *
-   * @method setAttr
    * @public
    * @param identifier
    * @param propertyName
@@ -2656,7 +2584,6 @@ class CacheManager {
   /**
    * Query the cache for the changed attributes of a resource.
    *
-   * @method changedAttrs
    * @public
    * @param identifier
    * @return
@@ -2668,7 +2595,6 @@ class CacheManager {
   /**
    * Query the cache for whether any mutated attributes exist
    *
-   * @method hasChangedAttrs
    * @public
    * @param identifier
    * @return {Boolean}
@@ -2680,7 +2606,6 @@ class CacheManager {
   /**
    * Tell the cache to discard any uncommitted mutations to attributes
    *
-   * @method rollbackAttrs
    * @public
    * @param identifier
    * @return the names of attributes that were restored
@@ -2714,7 +2639,6 @@ class CacheManager {
     };
     ```
    *
-   * @method changedRelationships
    * @public
    * @param {StableRecordIdentifier} identifier
    * @return {Map<string, RelationshipDiff>}
@@ -2726,7 +2650,6 @@ class CacheManager {
   /**
    * Query the cache for whether any mutated attributes exist
    *
-   * @method hasChangedRelationships
    * @public
    * @param {StableRecordIdentifier} identifier
    * @return {Boolean}
@@ -2742,7 +2665,6 @@ class CacheManager {
    *
    * This method is a candidate to become a mutation
    *
-   * @method rollbackRelationships
    * @public
    * @param {StableRecordIdentifier} identifier
    * @return {String[]} the names of relationships that were restored
@@ -2754,7 +2676,6 @@ class CacheManager {
   /**
    * Query the cache for the current state of a relationship property
    *
-   * @method getRelationship
    * @public
    * @param identifier
    * @param propertyName
@@ -2767,7 +2688,6 @@ class CacheManager {
   /**
    * Query the cache for the remote state of a relationship property
    *
-   * @method getRelationship
    * @public
    * @param identifier
    * @param propertyName
@@ -2784,7 +2704,6 @@ class CacheManager {
    * Update the cache state for the given resource to be marked as locally deleted,
    * or remove such a mark.
    *
-   * @method setIsDeleted
    * @public
    * @param identifier
    * @param isDeleted
@@ -2796,7 +2715,6 @@ class CacheManager {
   /**
    * Query the cache for any validation errors applicable to the given resource.
    *
-   * @method getErrors
    * @public
    * @param identifier
    * @return
@@ -2808,7 +2726,6 @@ class CacheManager {
   /**
    * Query the cache for whether a given resource has any available data
    *
-   * @method isEmpty
    * @public
    * @param identifier
    * @return {Boolean}
@@ -2821,7 +2738,6 @@ class CacheManager {
    * Query the cache for whether a given resource was created locally and not
    * yet persisted.
    *
-   * @method isNew
    * @public
    * @param identifier
    * @return {Boolean}
@@ -2834,7 +2750,6 @@ class CacheManager {
    * Query the cache for whether a given resource is marked as deleted (but not
    * necessarily persisted yet).
    *
-   * @method isDeleted
    * @public
    * @param identifier
    * @return {Boolean}
@@ -2847,7 +2762,6 @@ class CacheManager {
    * Query the cache for whether a given resource has been deleted and that deletion
    * has also been persisted.
    *
-   * @method isDeletionCommitted
    * @public
    * @param identifier
    * @return {Boolean}
@@ -2856,11 +2770,6 @@ class CacheManager {
     return this.#cache.isDeletionCommitted(identifier);
   }
 }
-
-/**
- * @module @ember-data/store
- */
-
 function isCacheOperationValue(value) {
   return value === 'added' || value === 'state' || value === 'updated' || value === 'removed' || value === 'invalidated';
 }
@@ -2945,7 +2854,6 @@ class NotificationManager {
    * }
    * ```
    *
-   * @method subscribe
    * @public
    * @param {StableDocumentIdentifier | StableRecordIdentifier | 'resource' | 'document'} identifier
    * @param {NotificationCallback | ResourceOperationCallback | DocumentOperationCallback} callback
@@ -2983,7 +2891,6 @@ class NotificationManager {
   /**
    * remove a previous subscription
    *
-   * @method unsubscribe
    * @public
    * @param {UnsubscribeToken} token
    */
@@ -2996,7 +2903,6 @@ class NotificationManager {
   /**
    * Custom Caches and Application Code should not call this method directly.
    *
-   * @method notify
    * @param identifier
    * @param value
    * @param key
@@ -3126,11 +3032,6 @@ class NotificationManager {
 */
 
 const NativeProxy = Proxy;
-
-/**
-  @module @ember-data/store
-*/
-
 const ARRAY_GETTER_METHODS = new Set([Symbol.iterator, 'concat', 'entries', 'every', 'fill', 'filter', 'find', 'findIndex', 'flat', 'flatMap', 'forEach', 'includes', 'indexOf', 'join', 'keys', 'lastIndexOf', 'map', 'reduce', 'reduceRight', 'slice', 'some', 'values']);
 const ARRAY_SETTER_METHODS = new Set(['push', 'pop', 'unshift', 'shift', 'splice', 'sort']);
 const SYNC_PROPS = new Set(['[]', 'length', 'links', 'meta']);
@@ -3482,8 +3383,7 @@ class IdentifierArray {
     });
      people.isUpdating; // true
     ```
-     @method update
-    @public
+     @public
   */
   update() {
     if (this.isUpdating) {
@@ -3532,8 +3432,7 @@ class IdentifierArray {
     });
     messages.save();
     ```
-     @method save
-    @public
+     @public
     @return {Promise<IdentifierArray>} promise
   */
   save() {
@@ -3626,11 +3525,6 @@ function extractIdentifierFromRecord$2(record) {
   assertRecordPassedToHasMany$1(record);
   return recordIdentifierFor(record);
 }
-
-/**
-  @module @ember-data/store
-*/
-
 const FAKE_ARR = getOrSetGlobal('FAKE_ARR', {});
 const SLICE_BATCH_SIZE = 1200;
 /**
@@ -3758,8 +3652,7 @@ class RecordArrayManager {
   /**
     Get the `RecordArray` for a modelName, which contains all loaded records of
     given modelName.
-     @method liveArrayFor
-    @internal
+     @internal
     @param {String} modelName
     @return {RecordArray}
   */
@@ -4028,11 +3921,6 @@ function sync(array, changes, arraySet) {
 function isCollection(array) {
   return array.identifier !== null;
 }
-
-/**
- * @module @ember-data/store
- */
-
 const Touching = getOrSetGlobal('Touching', Symbol('touching'));
 const RequestPromise = getOrSetGlobal('RequestPromise', Symbol('promise'));
 const EMPTY_ARR = macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? Object.freeze([]) : [];
@@ -4189,7 +4077,6 @@ class RequestStateService {
    * with the RequestManager for these purposes is likely to be a better long-term
    * design.
    *
-   * @method subscribeForRecord
    * @public
    * @param {StableRecordIdentifier} identifier
    * @param {(state: RequestCacheRequestState) => void} callback
@@ -4206,7 +4093,6 @@ class RequestStateService {
   /**
    * Retrieve all active requests for a given resource identity.
    *
-   * @method getPendingRequestsForRecord
    * @public
    * @param {StableRecordIdentifier} identifier
    * @return {RequestCacheRequestState[]} an array of request states for any pending requests for the given identifier
@@ -4218,7 +4104,6 @@ class RequestStateService {
   /**
    * Retrieve the last completed request for a given resource identity.
    *
-   * @method getLastRequestForRecord
    * @public
    * @param {StableRecordIdentifier} identifier
    * @return {RequestCacheRequestState | null} the state of the most recent request for the given identifier
@@ -4283,9 +4168,6 @@ function constructResource(type, id, lid) {
   }
 }
 
-/**
-  @module @ember-data/store
- */
 // this import location is deprecated but breaks in 4.8 and older
 
 // @ts-expect-error adding to globalThis
@@ -4417,7 +4299,6 @@ if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_METRIC_COUNTS))
  * TODO: These are limitations we want to (and can) address. If you
  * have need of lifting these limitations, please open an issue.
  *
- * @typedoc
  */
 
 /**
@@ -4425,7 +4306,7 @@ if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_METRIC_COUNTS))
  * and sources of data (such as your API or a local persistence layer)
  * accessed via a [RequestManager](https://github.com/emberjs/data/tree/main/packages/request).
  *
- * ```app/services/store.js
+ * ```js [app/services/store.js]
  * import Store from '@ember-data/store';
  *
  * export default class extends Store {}
@@ -4474,6 +4355,8 @@ const app = new EmberApp(defaults, {
   });
 }
 class Store extends BaseClass {
+  /** @internal */
+
   /**
    * Provides access to the NotificationManager associated
    * with this Store instance.
@@ -4503,6 +4386,7 @@ class Store extends BaseClass {
     }
     return this._schema;
   }
+  /** @internal */
 
   /**
    * Provides access to the IdentifierCache instance
@@ -4574,6 +4458,15 @@ class Store extends BaseClass {
    */
 
   // Private
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
 
   /**
    * Async flush buffers notifications until flushed
@@ -4587,13 +4480,20 @@ class Store extends BaseClass {
    */
 
   // DEBUG-only properties
+  /** @internal */
+
+  /** @internal */
 
+  /** @internal */
+
+  /** @internal */
   get isDestroying() {
     return this._isDestroying;
   }
   set isDestroying(value) {
     this._isDestroying = value;
   }
+  /** @internal */
   get isDestroyed() {
     return this._isDestroyed;
   }
@@ -4602,7 +4502,6 @@ class Store extends BaseClass {
   }
 
   /**
-    @method init
     @private
   */
   constructor(createArgs) {
@@ -4622,6 +4521,8 @@ class Store extends BaseClass {
     this.isDestroying = false;
     this.isDestroyed = false;
   }
+
+  /** @internal */
   _run(cb) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
       if (!test) {
@@ -4675,6 +4576,8 @@ class Store extends BaseClass {
       this._run(cb);
     }
   }
+
+  /** @internal */
   _schedule(name, cb) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
       if (!test) {
@@ -4696,13 +4599,14 @@ class Store extends BaseClass {
    * This can be used to query the status of requests
    * that have been initiated for a given identifier.
    *
-   * @method getRequestStateService
    * @return {RequestStateService}
    * @public
    */
   getRequestStateService() {
     return this._requestCache;
   }
+
+  /** @internal */
   _getAllPending() {
     if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
       const all = [];
@@ -4765,7 +4669,6 @@ class Store extends BaseClass {
    * is that `store.request` will attempt to hydrate the response content into
    * a response Document containing RecordInstances.
    *
-   * @method request
    * @param {StoreRequestInput} requestConfig
    * @return {Future}
    * @public
@@ -4826,7 +4729,6 @@ class Store extends BaseClass {
    * mechanism of presenting cache data to the ui for access
    * mutation, and interaction.
    *
-   * @method instantiateRecord (hook)
    * @param identifier
    * @param createRecordArgs
    * @param recordDataFor deprecated use this.cache
@@ -4841,7 +4743,6 @@ class Store extends BaseClass {
    * be used to teardown any custom record instances instantiated
    * with `instantiateRecord`.
    *
-   * @method teardownRecord (hook)
    * @public
    * @param record
    */
@@ -4859,8 +4760,7 @@ class Store extends BaseClass {
     relationship names of the model, see
     [`relationshipNames`](/ember-data/release/classes/Model?anchor=relationshipNames)
     for example.
-     @method modelFor
-    @public
+     @public
     @deprecated
     @param {String} type
     @return {ModelSchema}
@@ -4904,8 +4804,7 @@ class Store extends BaseClass {
       user: user
     });
     ```
-     @method createRecord
-    @public
+     @public
     @param {String} type the name of the resource
     @param {Object} inputProperties a hash of properties to set on the
       newly created record.
@@ -4984,8 +4883,7 @@ class Store extends BaseClass {
     });
      store.deleteRecord(post);
     ```
-     @method deleteRecord
-    @public
+     @public
     @param {unknown} record
   */
   deleteRecord(record) {
@@ -5015,8 +4913,7 @@ class Store extends BaseClass {
     const { content: { data: post } } = await store.request(findRecord({ type: 'post', id: '1' }));
     store.unloadRecord(post);
     ```
-     @method unloadRecord
-    @public
+     @public
     @param {Model} record
   */
   unloadRecord(record) {
@@ -5036,7 +4933,7 @@ class Store extends BaseClass {
      The `findRecord` method will always return a **promise** that will be
     resolved with the record.
      **Example 1**
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     export default class PostRoute extends Route {
       model({ post_id }) {
         return this.store.findRecord('post', post_id);
@@ -5047,7 +4944,7 @@ class Store extends BaseClass {
      `findRecord` can be called with a single identifier argument instead of the combination
     of `type` (modelName) and `id` as separate arguments. You may recognize this combo as
     the typical pairing from [JSON:API](https://jsonapi.org/format/#document-resource-object-identification)
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     export default class PostRoute extends Route {
       model({ post_id: id }) {
         return this.store.findRecord({ type: 'post', id });
@@ -5057,7 +4954,7 @@ class Store extends BaseClass {
      **Example 3**
      If you have previously received an lid via an Identifier for this record, and the record
     has already been assigned an id, you can find the record again using just the lid.
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     store.findRecord({ lid });
     ```
      If the record is not yet available, the store will ask the adapter's `findRecord`
@@ -5070,7 +4967,7 @@ class Store extends BaseClass {
      For example, if your Ember route looks like `/posts/1/comments/2` and your API route
     for the comment also looks like `/posts/1/comments/2` if you want to fetch the comment
     without also fetching the post you can pass in the post to the `findRecord` call:
-     ```app/routes/post-comments.js
+     ```js [app/routes/post-comments.js]
     export default class PostRoute extends Route {
       model({ post_id, comment_id: id }) {
         return this.store.findRecord({ type: 'comment', id, { preload: { post: post_id }} });
@@ -5079,7 +4976,7 @@ class Store extends BaseClass {
     ```
      In your adapter you can then access this id without triggering a network request via the
     snapshot:
-     ```app/adapters/application.js
+     ```js [app/adapters/application.js]
     export default class Adapter {
        findRecord(store, schema, id, snapshot) {
         let type = schema.modelName;
@@ -5096,14 +4993,14 @@ class Store extends BaseClass {
     ```
      This could also be achieved by supplying the post id to the adapter via the adapterOptions
     property on the options hash.
-     ```app/routes/post-comments.js
+     ```js [app/routes/post-comments.js]
     export default class PostRoute extends Route {
       model({ post_id, comment_id: id }) {
         return this.store.findRecord({ type: 'comment', id, { adapterOptions: { post: post_id }} });
       }
     }
     ```
-     ```app/adapters/application.js
+     ```js [app/adapters/application.js]
     export default class Adapter {
       findRecord(store, schema, id, snapshot) {
         let type = schema.modelName;
@@ -5190,7 +5087,7 @@ class Store extends BaseClass {
      If you would like to force or prevent background reloading, you can set a
     boolean value for `backgroundReload` in the options object for
     `findRecord`.
-     ```app/routes/post/edit.js
+     ```js [app/routes/post/edit.js]
     export default class PostEditRoute extends Route {
       model(params) {
         return this.store.findRecord('post', params.post_id, { backgroundReload: false });
@@ -5199,7 +5096,7 @@ class Store extends BaseClass {
     ```
      If you pass an object on the `adapterOptions` property of the options
     argument it will be passed to your adapter via the snapshot
-     ```app/routes/post/edit.js
+     ```js [app/routes/post/edit.js]
     export default class PostEditRoute extends Route {
       model(params) {
         return this.store.findRecord('post', params.post_id, {
@@ -5208,7 +5105,7 @@ class Store extends BaseClass {
       }
     }
     ```
-     ```app/adapters/post.js
+     ```js [app/adapters/post.js]
     import MyCustomAdapter from './custom-adapter';
      export default class PostAdapter extends MyCustomAdapter {
       findRecord(store, type, id, snapshot) {
@@ -5231,14 +5128,14 @@ class Store extends BaseClass {
      For example, given a `post` model that has a `hasMany` relationship with a `comment`
     model, when we retrieve a specific post we can have the server also return that post's
     comments in the same request:
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     export default class PostRoute extends Route {
       model(params) {
         return this.store.findRecord('post', params.post_id, { include: ['comments'] });
       }
     }
     ```
-     ```app/adapters/application.js
+     ```js [app/adapters/application.js]
     export default class Adapter {
       findRecord(store, schema, id, snapshot) {
         let type = schema.modelName;
@@ -5259,7 +5156,7 @@ class Store extends BaseClass {
     list of relationship names, while nested relationships can be specified
     using a dot-separated sequence of relationship names. So to request both the post's
     comments and the authors of those comments the request would look like this:
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     export default class PostRoute extends Route {
       model(params) {
         return this.store.findRecord('post', params.post_id, { include: ['comments','comments.author'] });
@@ -5270,7 +5167,7 @@ class Store extends BaseClass {
      If your server endpoint supports the use of a ['fields' query parameter](https://jsonapi.org/format/#fetching-sparse-fieldsets),
     you can use pass those fields through to your server.  At this point in time, this requires a few manual steps on your part.
      1. Implement `buildQuery` in your adapter.
-     ```app/adapters/application.js
+     ```js [app/adapters/application.js]
     buildQuery(snapshot) {
       let query = super.buildQuery(...arguments);
        let { fields } = snapshot.adapterOptions;
@@ -5282,7 +5179,7 @@ class Store extends BaseClass {
     ```
      2. Then pass through the applicable fields to your `findRecord` request.
      Given a `post` model with attributes body, title, publishDate and meta, you can retrieve a filtered list of attributes.
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     export default class extends Route {
       model(params) {
         return this.store.findRecord('post', params.post_id, { adapterOptions: { fields: { post: 'body,title' } });
@@ -5291,7 +5188,7 @@ class Store extends BaseClass {
     ```
      Moreover, you can filter attributes on related models as well. If a `post` has a `belongsTo` relationship to a user,
     just include the relationship key and attributes.
-     ```app/routes/post.js
+     ```js [app/routes/post.js]
     export default class extends Route {
       model(params) {
         return this.store.findRecord('post', params.post_id, { adapterOptions: { fields: { post: 'body,title', user: 'name,email' } });
@@ -5299,7 +5196,6 @@ class Store extends BaseClass {
     }
     ```
      @since 1.13.0
-    @method findRecord
     @public
     @param {String|object} type - either a string representing the name of the resource or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record
     @param {(String|Integer|Object)} id - optional object with options for the request only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved
@@ -5378,8 +5274,7 @@ class Store extends BaseClass {
       userRef.value() === user;
     });
     ```
-     @method getReference
-    @public
+     @public
     @param {String|object} resource - modelName (string) or Identifier (object)
     @param {String|Integer} id
     @since 2.5.0
@@ -5435,7 +5330,6 @@ class Store extends BaseClass {
     post.id; // '1'
     ```
       @since 1.13.0
-    @method peekRecord
     @public
     @param {String|object} modelName - either a string representing the modelName or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record
     @param {String|Integer} id - optional only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved.
@@ -5504,7 +5398,6 @@ class Store extends BaseClass {
     [`Collection`](/ember-data/release/classes/Collection)
     once the server returns.
      @since 1.13.0
-    @method query
     @public
     @param {String} type the name of the resource
     @param {Object} query a query to be used by the adapter
@@ -5572,7 +5465,7 @@ class Store extends BaseClass {
     });
     ```
      The request is made through the adapters' `queryRecord`:
-     ```app/adapters/user.js
+     ```js [app/adapters/user.js]
     import Adapter from '@ember-data/adapter';
     import $ from 'jquery';
      export default class UserAdapter extends Adapter {
@@ -5619,7 +5512,6 @@ class Store extends BaseClass {
     });
     ```
      @since 1.13.0
-    @method queryRecord
     @public
     @param {String} type
     @param {Object} query an opaque query to be used by the adapter
@@ -5665,7 +5557,7 @@ class Store extends BaseClass {
     given type, and returns a promise which will resolve with all records of
     this type present in the store, even if the adapter only returns a subset
     of them.
-     ```app/routes/authors.js
+     ```js [app/routes/authors.js]
     export default class AuthorsRoute extends Route {
       model(params) {
         return this.store.findAll('author');
@@ -5704,7 +5596,7 @@ class Store extends BaseClass {
     then a background reload is started. Once this resolves, the array with
     which the promise resolves, is updated automatically so it contains all the
     records in the store:
-     ```app/adapters/application.js
+     ```js [app/adapters/application.js]
     import Adapter from '@ember-data/adapter';
      export default class ApplicationAdapter extends Adapter {
       shouldReloadAll(store, snapshotsArray) {
@@ -5738,7 +5630,7 @@ class Store extends BaseClass {
      If you would like to force or prevent background reloading, you can set a
     boolean value for `backgroundReload` in the options object for
     `findAll`.
-     ```app/routes/post/edit.js
+     ```js [app/routes/post/edit.js]
     export default class PostEditRoute extends Route {
       model() {
         return this.store.findAll('post', { backgroundReload: false });
@@ -5747,7 +5639,7 @@ class Store extends BaseClass {
     ```
      If you pass an object on the `adapterOptions` property of the options
     argument it will be passed to you adapter via the `snapshotRecordArray`
-     ```app/routes/posts.js
+     ```js [app/routes/posts.js]
     export default class PostsRoute extends Route {
       model(params) {
         return this.store.findAll('post', {
@@ -5756,7 +5648,7 @@ class Store extends BaseClass {
       }
     }
     ```
-     ```app/adapters/post.js
+     ```js [app/adapters/post.js]
     import MyCustomAdapter from './custom-adapter';
      export default class UserAdapter extends MyCustomAdapter {
       findAll(store, type, sinceToken, snapshotRecordArray) {
@@ -5780,7 +5672,7 @@ class Store extends BaseClass {
      For example, given a `post` model that has a `hasMany` relationship with a `comment`
     model, when we retrieve all of the post records we can have the server also return
     all of the posts' comments in the same request:
-     ```app/routes/posts.js
+     ```js [app/routes/posts.js]
     export default class PostsRoute extends Route {
       model() {
         return this.store.findAll('post', { include: ['comments'] });
@@ -5791,7 +5683,7 @@ class Store extends BaseClass {
     list or relationship names, while nested relationships can be specified
     using a dot-separated sequence of relationship names. So to request both the posts'
     comments and the authors of those comments the request would look like this:
-     ```app/routes/posts.js
+     ```js [app/routes/posts.js]
     export default class PostsRoute extends Route {
       model() {
         return this.store.findAll('post', { include: ['comments','comments.author'] });
@@ -5800,7 +5692,6 @@ class Store extends BaseClass {
     ```
      See [query](../methods/query?anchor=query) to only get a subset of records from the server.
      @since 1.13.0
-    @method findAll
     @public
     @param {String} type the name of the resource
     @param {Object} options
@@ -5849,7 +5740,6 @@ class Store extends BaseClass {
     let localPosts = store.peekAll('post');
     ```
      @since 1.13.0
-    @method peekAll
     @public
     @param {String} type the name of the resource
     @return {RecordArray}
@@ -5880,8 +5770,7 @@ class Store extends BaseClass {
     store.unloadAll();
     store.unloadAll('post');
     ```
-     @method unloadAll
-    @param {String} type the name of the resource
+     @param {String} type the name of the resource
     @public
   */
 
@@ -5962,7 +5851,7 @@ class Store extends BaseClass {
       - [`data`](http://jsonapi.org/format/#document-resource-object-linkage) - place for primary data
       - [`meta`](http://jsonapi.org/format/#document-meta) - object which contains meta-information about relationship
      For this model:
-     ```app/models/person.js
+     ```js [app/models/person.js]
     import Model, { attr, hasMany } from '@ember-data/model';
      export default class PersonRoute extends Route {
       @attr('string') firstName;
@@ -6032,8 +5921,7 @@ class Store extends BaseClass {
     ```
      This method can be used both to push in brand new
     records, as well as to update existing records.
-     @method push
-    @public
+     @public
     @param {Object} data
     @return the record(s) that was created or
       updated.
@@ -6056,8 +5944,7 @@ class Store extends BaseClass {
   /**
     Push some data in the form of a json-api document into the store,
     without creating materialized records.
-     @method _push
-    @private
+     @private
     @param {Object} jsonApiDoc
     @return {StableRecordIdentifier|Array<StableRecordIdentifier>|null} identifiers for the primary records that had data loaded
   */
@@ -6083,7 +5970,6 @@ class Store extends BaseClass {
    *
    * Returns a promise resolving with the same record when the save is complete.
    *
-   * @method saveRecord
    * @public
    * @param {unknown} record
    * @param options
@@ -6143,7 +6029,6 @@ class Store extends BaseClass {
    * This hook should not be called directly by consuming applications or libraries.
    * Use `Store.cache` to access the Cache instance.
    *
-   * @method createCache (hook)
    * @public
    * @param storeWrapper
    * @return {Cache}
@@ -6379,10 +6264,6 @@ function getPriority(identifier, deduped, priority) {
   return priority;
 }
 
-/**
- * @module @ember-data/store
- */
-
 /**
  * A CacheHandler that adds support for using an EmberData Cache with a RequestManager.
  *
@@ -6422,7 +6303,6 @@ function getPriority(identifier, deduped, priority) {
  *   [EnableHydration]: true
  * });
  *
- * @typedoc
  */
 const CacheHandler = {
   request(context, next) {
@@ -6667,9 +6547,6 @@ function fetchContentAndHydrate(next, context, identifier, priority) {
   });
 }
 
-/**
-  @module @ember-data/store
-*/
 /**
   A `ManyArray` is a `MutableArray` that represents the contents of a has-many
   relationship.
@@ -6685,7 +6562,7 @@ function fetchContentAndHydrate(next, context, identifier, priority) {
   an inverse. For example, imagine the following models are
   defined:
 
-  ```app/models/post.js
+  ```js [app/models/post.js]
   import Model, { hasMany } from '@ember-data/model';
 
   export default class PostModel extends Model {
@@ -6693,7 +6570,7 @@ function fetchContentAndHydrate(next, context, identifier, priority) {
   }
   ```
 
-  ```app/models/comment.js
+  ```js [app/models/comment.js]
   import Model, { belongsTo } from '@ember-data/model';
 
   export default class CommentModel extends Model {
@@ -6988,8 +6865,7 @@ class RelatedCollection extends IdentifierArray {
      let permissions = await user.permissions;
     await permissions.reload();
     ```
-     @method reload
-    @public
+     @public
   */
   reload(options) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -7001,27 +6877,9 @@ class RelatedCollection extends IdentifierArray {
     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
+     @public
     @param {Object} hash
     @return {Model} record
   */
@@ -7038,6 +6896,24 @@ class RelatedCollection extends IdentifierArray {
     this.push(record);
     return record;
   }
+
+  /**
+    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();
+    ```
+     @public
+    @return {PromiseArray} promise
+  */
+
+  /** @internal */
   destroy() {
     super.destroy(false);
   }
@@ -7145,7 +7021,6 @@ const PromiseCache = new WeakMap();
  * The state of a promise in the "pending"
  * state. This is the default initial state.
  *
- * @typedoc
  */
 
 /**
@@ -7153,7 +7028,6 @@ const PromiseCache = new WeakMap();
  * This is the state of a promise that has resolved
  * successfully.
  *
- * @typedoc
  */
 
 /**
@@ -7161,7 +7035,6 @@ const PromiseCache = new WeakMap();
  * This is the state of a promise that has rejected
  * with an error.
  *
- * @typedoc
  */
 
 /**
@@ -7173,7 +7046,6 @@ const PromiseCache = new WeakMap();
  * - {@link ResolvedPromise}
  * - {@link RejectedPromise}
  *
- * @typedoc
  */
 
 const PromiseStateProto = {};
@@ -7294,7 +7166,6 @@ function getPromise(promise) {
  *
  * If looking to use in a template, consider also the `<Await />` component.
  *
- * @typedoc
  */
 function getPromiseState(promise) {
   const _promise = getPromise(promise);
@@ -7368,7 +7239,6 @@ async function watchStream(stream, state) {
  * reactive properties that can be used to build UIs that respond
  * to the progress of a request.
  *
- * @typedoc
  */
 class RequestLoadingState {
   _stream = null;
@@ -7498,7 +7368,6 @@ defineNonEnumerableSignal(RequestLoadingState.prototype, '_lastPacketTime', 0);
  *
  * Extends the {@link PendingPromise} interface.
  *
- * @typedoc
  */
 
 /**
@@ -7508,7 +7377,6 @@ defineNonEnumerableSignal(RequestLoadingState.prototype, '_lastPacketTime', 0);
  *
  * Extends the {@link ResolvedPromise} interface.
  *
- * @typedoc
  */
 
 /**
@@ -7518,7 +7386,6 @@ defineNonEnumerableSignal(RequestLoadingState.prototype, '_lastPacketTime', 0);
  *
  * Extends the {@link RejectedPromise} interface.
  *
- * @typedoc
  */
 
 /**
@@ -7526,7 +7393,6 @@ defineNonEnumerableSignal(RequestLoadingState.prototype, '_lastPacketTime', 0);
  * This is the state of a promise that has been
  * cancelled.
  *
- * @typedoc
  */
 
 /**
@@ -7560,7 +7426,6 @@ defineNonEnumerableSignal(RequestLoadingState.prototype, '_lastPacketTime', 0);
  * - {@link RejectedRequest}
  * - {@link CancelledRequest}
  *
- * @typedoc
  */
 
 const RequestStateProto = {};
@@ -7696,7 +7561,6 @@ function createRequestState(future) {
  * which offers a numbe of additional capabilities for requests *beyond* what
  * `RequestState` provides.
  *
- * @typedoc
  */
 function getRequestState(future) {
   let state = RequestCache.get(future);