@warp-drive/core 5.6.0-alpha.15 → 5.6.0-alpha.18

package/dist/{request-state-CCOJIj5i.js → request-state-CjLph1LP.js}

@@ -393,7 +393,7 @@ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
 }
 
 /**
- * Each instance of {Store} receives a unique instance of a IdentifierCache.
+ * Each instance of {@link Store} receives a unique instance of a IdentifierCache.
  *
  * This cache is responsible for assigning or retrieving the unique identify
  * for arbitrary resource data encountered by the store. Data representing
@@ -402,10 +402,12 @@ if (macroCondition(getGlobalConfig().WarpDrive.env.DEBUG)) {
  *
  * It can be configured by consuming applications.
  *
- * @class IdentifierCache
-   @public
+ * @hideconstructor
+ * @public
  */
 class IdentifierCache {
+  /** @internal */
+
   constructor() {
     // we cache the user configuredGenerationMethod at init because it must
     // be configured prior and is not allowed to be changed
@@ -435,6 +437,8 @@ class IdentifierCache {
   __configureMerge(method) {
     this._merge = method || defaultMergeMethod;
   }
+
+  /** @internal */
   upgradeIdentifier(resource) {
     return this._getRecordIdentifier(resource, 2);
   }
@@ -524,8 +528,6 @@ class IdentifierCache {
    * useful for the "create" case when we need to see if
    * we are accidentally overwritting something
    *
-   * @param resource
-   * @return {StableRecordIdentifier | undefined}
    * @private
    */
   peekRecordIdentifier(resource) {
@@ -535,9 +537,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`.
-     @param request
-    @return {StableDocumentIdentifier | null}
-    @public
+     @public
   */
   getOrCreateDocumentIdentifier(request) {
     let cacheKey = request.cacheOptions?.key;
@@ -568,9 +568,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
-     @param resource
-    @return {StableRecordIdentifier}
-    @public
+     @public
   */
   getOrCreateRecordIdentifier(resource) {
     return this._getRecordIdentifier(resource, 1);
@@ -582,9 +580,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')`.
-    @param data
-   @return {StableRecordIdentifier}
-   @public
+    @public
   */
   createIdentifierForNewRecord(data) {
     const newLid = this._generate(data, 'record');
@@ -625,10 +621,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.
-     @param identifierObject
-    @param data
-    @return {StableRecordIdentifier}
-    @public
+     @public
   */
   updateRecordIdentifier(identifierObject, data) {
     let identifier = this.getOrCreateRecordIdentifier(identifierObject);
@@ -741,8 +734,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.
-    @param identifierObject
-   @public
+    @public
   */
   forgetRecordIdentifier(identifierObject) {
     const identifier = this.getOrCreateRecordIdentifier(identifierObject);
@@ -776,6 +768,8 @@ class IdentifierCache {
       }
     }
   }
+
+  /** @internal */
   destroy() {
     NEW_IDENTIFIERS.clear();
     this._cache.documents.forEach(identifier => {
@@ -1568,13 +1562,12 @@ function _log(scope, prefix, subScop1, subScop2, subScop3, subScop4) {
    A `RecordReference` is a low-level API that allows users and
    addon authors to perform meta-operations on a record.
 
-   @class RecordReference
+   @hideconstructor
    @public
 */
 class RecordReference {
   // unsubscribe token given to us by the notification manager
-  ___token;
-  ___identifier;
+
   constructor(store, identifier) {
     this.store = store;
     this.___identifier = identifier;
@@ -1584,6 +1577,8 @@ class RecordReference {
       }
     });
   }
+
+  /** @internal */
   destroy() {
     this.store.notifications.unsubscribe(this.___token);
   }
@@ -1601,7 +1596,6 @@ class RecordReference {
       userRef.id(); // '1'
      ```
      @public
-     @return {String} The id of the record.
   */
   id() {
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
@@ -1619,7 +1613,6 @@ class RecordReference {
       userRef.identifier(); // '1'
      ```
      @public
-     @return {String} The identifier of the record.
   */
   identifier() {
     return this.___identifier;
@@ -1635,7 +1628,6 @@ class RecordReference {
       userRef.remoteType(); // 'identity'
      ```
       @public
-     @return {String} 'identity'
   */
   remoteType() {
     return 'identity';
@@ -1690,7 +1682,6 @@ class RecordReference {
       userRef.value(); // user
      ```
      @public
-     @return {Model} the record for this RecordReference
   */
   value() {
     return this.store.peekRecord(this.___identifier);
@@ -1706,7 +1697,6 @@ class RecordReference {
      userRef.load().then(...)
      ```
      @public
-     @return {Promise<record>} the record for this RecordReference
   */
   load() {
     const id = this.id();
@@ -1730,7 +1720,6 @@ class RecordReference {
      userRef.reload().then(...)
      ```
      @public
-     @return {Promise<record>} the record for this RecordReference
   */
   reload() {
     const id = this.id();
@@ -2977,10 +2966,22 @@ function _unsubscribe(token, cache) {
  * This Feature is what allows WarpDrive to create subscriptions that
  * work with any framework or change-notification system.
  *
- * @class NotificationManager
+ * @hideconstructor
  * @public
  */
 class NotificationManager {
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
+  /** @internal */
+
   constructor(store) {
     this.store = store;
     this.isDestroyed = false;
@@ -3048,7 +3049,6 @@ class NotificationManager {
    * remove a previous subscription
    *
    * @public
-   * @param {UnsubscribeToken} token
    */
   unsubscribe(token) {
     if (!this.isDestroyed) {
@@ -3059,10 +3059,6 @@ class NotificationManager {
   /**
    * Custom Caches and Application Code should not call this method directly.
    *
-   * @param identifier
-   * @param value
-   * @param key
-   * @return {Boolean} whether a notification was delivered to any subscribers
    * @private
    */
 
@@ -3115,6 +3111,8 @@ class NotificationManager {
     }
     return hasSubscribers;
   }
+
+  /** @internal */
   _onNextFlush(cb) {
     this._onFlushCB = cb;
   }
@@ -3132,6 +3130,8 @@ class NotificationManager {
     this._flush();
     return true;
   }
+
+  /** @internal */
   _flush() {
     const buffered = this._buffered;
     if (buffered.size) {
@@ -3173,6 +3173,8 @@ class NotificationManager {
     });
     return true;
   }
+
+  /** @internal */
   destroy() {
     this.isDestroyed = true;
     this._cache.clear();
@@ -3520,7 +3522,7 @@ class IdentifierArray {
                 }
               })(!transaction) : {};
               transaction = true;
-              const result = self[MUTATE](target, receiver, prop, args, _SIGNAL);
+              const result = options[MUTATE](target, receiver, prop, args, _SIGNAL);
               transaction = false;
               return result;
             };
@@ -3565,7 +3567,7 @@ class IdentifierArray {
         if (prop === 'length') {
           if (!transaction && value === 0) {
             transaction = true;
-            self[MUTATE](target, receiver, 'length 0', [], _SIGNAL);
+            options[MUTATE](target, receiver, 'length 0', [], _SIGNAL);
             transaction = false;
             return true;
           } else if (transaction) {
@@ -3639,7 +3641,7 @@ class IdentifierArray {
         // a transaction.
         // while "arr[arr.length] = newVal;" is handled by this replace cell code path.
         if (!transaction) {
-          self[MUTATE](target, receiver, 'replace cell', [index, original, newIdentifier], _SIGNAL);
+          options[MUTATE](target, receiver, 'replace cell', [index, original, newIdentifier], _SIGNAL);
         } else {
           target[index] = newIdentifier;
         }
@@ -4237,10 +4239,11 @@ function hasRecordIdentifier(op) {
  * The RequestStateService is used to track the state of requests
  * for fetching or updating known resource identifies that are inflight.
  *
- * @class RequestStateService
+ * @hideconstructor
  * @public
  */
 class RequestStateService {
+  /** @internal */
   _pending = new Map();
   _done = new Map();
   _subscriptions = new Map();
@@ -4249,9 +4252,11 @@ class RequestStateService {
   constructor(store) {
     this._store = store;
   }
+  /** @internal */
   _clearEntries(identifier) {
     this._done.delete(identifier);
   }
+  /** @internal */
   _enqueue(promise, queryRequest) {
     const query = queryRequest.data[0];
     if (hasRecordIdentifier(query)) {
@@ -4605,6 +4610,8 @@ if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_METRIC_COUNTS))
  *
  */
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+
 // eslint-disable-next-line @typescript-eslint/no-extraneous-class
 const EmptyClass = class {
   // eslint-disable-next-line @typescript-eslint/no-useless-constructor
@@ -6480,7 +6487,202 @@ function extractIdentifierFromRecord$1(recordOrPromiseRecord) {
   const extract = recordIdentifierFor;
   return extract(recordOrPromiseRecord);
 }
+function _MUTATE(target, receiver, prop, args, _SIGNAL) {
+  const collection = receiver;
+  switch (prop) {
+    case 'length 0':
+      {
+        Reflect.set(target, 'length', 0);
+        mutateReplaceRelatedRecords(collection, [], _SIGNAL);
+        return true;
+      }
+    case 'replace cell':
+      {
+        const [index, prior, value] = args;
+        target[index] = value;
+        mutateReplaceRelatedRecord(collection, {
+          value,
+          prior,
+          index
+        }, _SIGNAL);
+        return true;
+      }
+    case 'push':
+      {
+        const newValues = extractIdentifiersFromRecords(args);
+        assertNoDuplicates(collection, 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(collection, {
+              value: extractIdentifiersFromRecords(newArgs)
+            }, _SIGNAL);
+          }
+          return result;
+        }
 
+        // else, no dedupe, error on duplicates
+        const result = Reflect.apply(target[prop], receiver, args);
+        if (newValues.length) {
+          mutateAddToRelatedRecords(collection, {
+            value: newValues
+          }, _SIGNAL);
+        }
+        return result;
+      }
+    case 'pop':
+      {
+        const result = Reflect.apply(target[prop], receiver, args);
+        if (result) {
+          mutateRemoveFromRelatedRecords(collection, {
+            value: recordIdentifierFor(result)
+          }, _SIGNAL);
+        }
+        return result;
+      }
+    case 'unshift':
+      {
+        const newValues = extractIdentifiersFromRecords(args);
+        assertNoDuplicates(collection, 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(collection, {
+              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(collection, {
+            value: newValues,
+            index: 0
+          }, _SIGNAL);
+        }
+        return result;
+      }
+    case 'shift':
+      {
+        const result = Reflect.apply(target[prop], receiver, args);
+        if (result) {
+          mutateRemoveFromRelatedRecords(collection, {
+            value: recordIdentifierFor(result),
+            index: 0
+          }, _SIGNAL);
+        }
+        return result;
+      }
+    case 'sort':
+      {
+        const result = Reflect.apply(target[prop], receiver, args);
+        mutateSortRelatedRecords(collection, result.map(recordIdentifierFor), _SIGNAL);
+        return result;
+      }
+    case 'splice':
+      {
+        const [start, deleteCount, ...adds] = args;
+
+        // detect a full replace
+        if (start === 0 && deleteCount === collection[SOURCE].length) {
+          const newValues = extractIdentifiersFromRecords(adds);
+          assertNoDuplicates(collection, 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(collection, extractIdentifiersFromRecords(unique), _SIGNAL);
+            return result;
+          }
+
+          // else, no dedupe, error on duplicates
+          const result = Reflect.apply(target[prop], receiver, args);
+          mutateReplaceRelatedRecords(collection, newValues, _SIGNAL);
+          return result;
+        }
+        const newValues = extractIdentifiersFromRecords(adds);
+        assertNoDuplicates(collection, 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(collection, {
+              value: result.map(recordIdentifierFor),
+              index: start
+            }, _SIGNAL);
+          }
+          if (unique.length > 0) {
+            mutateAddToRelatedRecords(collection, {
+              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(collection, {
+            value: result.map(recordIdentifierFor),
+            index: start
+          }, _SIGNAL);
+        }
+        if (newValues.length > 0) {
+          mutateAddToRelatedRecords(collection, {
+            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`);
+        }
+      })() : {};
+  }
+}
 /**
   A `ManyArray` is a `MutableArray` that represents the contents of a has-many
   relationship.
@@ -6579,6 +6781,7 @@ class RelatedCollection extends IdentifierArray {
      */
 
   constructor(options) {
+    options[MUTATE] = _MUTATE;
     super(options);
     this.isLoaded = options.isLoaded || false;
     this.isAsync = options.isAsync || false;
@@ -6586,201 +6789,6 @@ class RelatedCollection extends IdentifierArray {
     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() {
     notifyInternalSignal(this[ARRAY_SIGNAL]);
   }
@@ -7137,6 +7145,8 @@ function isNeverString(val) {
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
  * A reactive class
  *
@@ -7236,6 +7246,7 @@ class RequestSubscription {
     this._invalidated = false;
     this._nextInterval = null;
     this.isDestroyed = false;
+    this[DISPOSE] = _DISPOSE;
     this._installListeners();
     void this._beginPolling();
   }
@@ -7621,36 +7632,11 @@ class RequestSubscription {
   }
 
   /**
-   * The method to call when the component this subscription is attached to
-   * unmounts.
+   * @internal
    */
   static {
     decorateMethodV2(this.prototype, "contentFeatures", [memoized]);
   }
-  [DISPOSE]() {
-    this.isDestroyed = true;
-    this._removeSubscriptions();
-    if (typeof window === 'undefined') {
-      return;
-    }
-    this._clearInterval();
-    window.removeEventListener('online', this._onlineChanged, {
-      passive: true,
-      capture: true
-    });
-    window.removeEventListener('offline', this._onlineChanged, {
-      passive: true,
-      capture: true
-    });
-    document.removeEventListener('visibilitychange', this._backgroundChanged, {
-      passive: true,
-      capture: true
-    });
-  }
-
-  /**
-   * @internal
-   */
   get _request() {
     const {
       request,
@@ -7728,11 +7714,39 @@ function isStore(store) {
 function createRequestSubscription(store, args) {
   return new RequestSubscription(store, args);
 }
+function upgradeSubscription(sub) {
+  return sub;
+}
+function _DISPOSE() {
+  const self = upgradeSubscription(this);
+  self.isDestroyed = true;
+  self._removeSubscriptions();
+  if (typeof window === 'undefined') {
+    return;
+  }
+  self._clearInterval();
+  window.removeEventListener('online', self._onlineChanged, {
+    passive: true,
+    capture: true
+  });
+  window.removeEventListener('offline', self._onlineChanged, {
+    passive: true,
+    capture: true
+  });
+  document.removeEventListener('visibilitychange', self._backgroundChanged, {
+    passive: true,
+    capture: true
+  });
+}
 const RequestCache = new WeakMap();
 function isAbortError(error) {
   return error instanceof DOMException && error.name === 'AbortError';
 }
-async function watchStream(stream, state) {
+function upgradeLoadingState(state) {
+  return state;
+}
+async function watchStream(stream, loadingState) {
+  const state = upgradeLoadingState(loadingState);
   const reader = stream.getReader();
   let bytesLoaded = 0;
   let shouldForward = state._stream !== null && state._stream.readable.locked;