@warp-drive/core 5.8.0-alpha.4 → 5.8.0-alpha.6

package/dist/request.js

@@ -1 +1 @@
-export { c as createDeferred, g as getPromiseResult, s as setPromiseResult } from "./context-C_7OLieY.js";
+export { c as createDeferred, g as getPromiseResult, s as setPromiseResult } from "./future-BKkJJkj7.js";

package/dist/store/-private.js

@@ -1,2 +1,2 @@
-export { C as CacheHandler, D as DISPOSE, R as RecordArrayManager, E as Signals, S as Store, k as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, h as assertPrivateCapabilities, d as assertPrivateStore, b as coerceId, c as constructResource, J as consumeInternalSignal, G as createInternalMemo, l as createLegacyManyArray, q as createRequestSubscription, A as defineGate, B as defineNonEnumerableSignal, z as defineSignal, e as ensureStringId, y as entangleInitiallyStaleSignal, x as entangleSignal, f as fastPush, w as gate, K as getOrCreateInternalSignal, p as getPromiseState, t as getRequestState, g as isPrivateStore, a as isRequestKey, i as isResourceKey, m as log, o as logGroup, v as memoized, I as notifyInternalSignal, F as peekInternalSignal, r as recordIdentifierFor, j as setRecordIdentifier, u as signal, s as storeFor, H as withSignalStore } from "../request-state-CUuZzgvE.js";
+export { C as CacheHandler, D as DISPOSE, R as RecordArrayManager, E as Signals, S as Store, k as StoreMap, _ as _clearCaches, n as _deprecatingNormalize, h as assertPrivateCapabilities, d as assertPrivateStore, b as coerceId, c as constructResource, J as consumeInternalSignal, G as createInternalMemo, l as createLegacyManyArray, q as createRequestSubscription, A as defineGate, B as defineNonEnumerableSignal, z as defineSignal, e as ensureStringId, y as entangleInitiallyStaleSignal, x as entangleSignal, f as fastPush, w as gate, K as getOrCreateInternalSignal, p as getPromiseState, t as getRequestState, g as isPrivateStore, a as isRequestKey, i as isResourceKey, m as log, o as logGroup, v as memoized, I as notifyInternalSignal, F as peekInternalSignal, r as recordIdentifierFor, j as setRecordIdentifier, u as signal, s as storeFor, H as withSignalStore } from "../index-Cg2akouS.js";
 export { A as ARRAY_SIGNAL, O as OBJECT_SIGNAL, w as waitFor } from "../configure-C3x8YXzL.js";

package/dist/store.js

@@ -1,533 +1 @@
-import { deprecate } from '@ember/debug';
-import { LRUCache } from './utils/string.js';
-import { macroCondition, getGlobalConfig } from '@embroider/macros';
-const NUMERIC_KEYS = new Set(['max-age', 's-maxage', 'stale-if-error', 'stale-while-revalidate']);
-
-/**
- *  Parses a string Cache-Control header value into an object with the following structure:
- *
- * ```ts
- * interface CacheControlValue {
- *   immutable?: boolean;
- *   'max-age'?: number;
- *   'must-revalidate'?: boolean;
- *   'must-understand'?: boolean;
- *   'no-cache'?: boolean;
- *   'no-store'?: boolean;
- *   'no-transform'?: boolean;
- *   'only-if-cached'?: boolean;
- *   private?: boolean;
- *   'proxy-revalidate'?: boolean;
- *   public?: boolean;
- *   's-maxage'?: number;
- *   'stale-if-error'?: number;
- *   'stale-while-revalidate'?: number;
- * }
- * ```
- *
- * @public
- * @param {String} header
- * @return {CacheControlValue}
- */
-function parseCacheControl(header) {
-  return CACHE_CONTROL_CACHE.get(header);
-}
-const CACHE_CONTROL_CACHE = new LRUCache(header => {
-  let key = '';
-  let value = '';
-  let isParsingKey = true;
-  const cacheControlValue = {};
-  for (let i = 0; i < header.length; i++) {
-    const char = header.charAt(i);
-    if (char === ',') {
-      macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-        if (!test) {
-          throw new Error(`Invalid Cache-Control value, expected a value`);
-        }
-      })(!isParsingKey || !NUMERIC_KEYS.has(key)) : {};
-      macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-        if (!test) {
-          throw new Error(`Invalid Cache-Control value, expected a value after "=" but got ","`);
-        }
-      })(i === 0 || header.charAt(i - 1) !== '=') : {};
-      isParsingKey = true;
-      // @ts-expect-error TS incorrectly thinks that optional keys must have a type that includes undefined
-      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? parseCacheControlValue(value) : true;
-      key = '';
-      value = '';
-      continue;
-    } else if (char === '=') {
-      macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-        if (!test) {
-          throw new Error(`Invalid Cache-Control value, expected a value after "="`);
-        }
-      })(i + 1 !== header.length) : {};
-      isParsingKey = false;
-    } else if (char === ' ' || char === `\t` || char === `\n`) {
-      continue;
-    } else if (isParsingKey) {
-      key += char;
-    } else {
-      value += char;
-    }
-    if (i === header.length - 1) {
-      // @ts-expect-error TS incorrectly thinks that optional keys must have a type that includes undefined
-      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? parseCacheControlValue(value) : true;
-    }
-  }
-  return cacheControlValue;
-}, 200);
-function parseCacheControlValue(stringToParse) {
-  const parsedValue = Number.parseInt(stringToParse);
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Invalid Cache-Control value, expected a number but got - ${stringToParse}`);
-    }
-  })(!Number.isNaN(parsedValue)) : {};
-  macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-    if (!test) {
-      throw new Error(`Invalid Cache-Control value, expected a number greater than 0 but got - ${stringToParse}`);
-    }
-  })(parsedValue >= 0) : {};
-  if (Number.isNaN(parsedValue) || parsedValue < 0) {
-    return 0;
-  }
-  return parsedValue;
-}
-function isExpired(cacheKey, request, config) {
-  const {
-    constraints
-  } = config;
-  if (constraints?.isExpired) {
-    const result = constraints.isExpired(request);
-    if (result !== null) {
-      if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-        if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-          // eslint-disable-next-line no-console
-          console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because constraints.isExpired returned ${result}`);
-        }
-      }
-      return result;
-    }
-  }
-  const {
-    headers
-  } = request.response;
-  if (!headers) {
-    if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-      if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-        // eslint-disable-next-line no-console
-        console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no headers were provided`);
-      }
-    }
-
-    // if we have no headers then both the headers based expiration
-    // and the time based expiration will be considered expired
-    return true;
-  }
-
-  // check for X-WarpDrive-Expires
-  const now = Date.now();
-  const date = headers.get('Date');
-  if (constraints?.headers) {
-    if (constraints.headers['X-WarpDrive-Expires']) {
-      const xWarpDriveExpires = headers.get('X-WarpDrive-Expires');
-      if (xWarpDriveExpires) {
-        const expirationTime = new Date(xWarpDriveExpires).getTime();
-        const result = now >= expirationTime;
-        if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-          if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-            // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by X-WarpDrive-Expires header is ${result ? 'in the past' : 'in the future'}`);
-          }
-        }
-        return result;
-      }
-    }
-
-    // check for Cache-Control
-    if (constraints.headers['Cache-Control']) {
-      const cacheControl = headers.get('Cache-Control');
-      const age = headers.get('Age');
-      if (cacheControl && age && date) {
-        const cacheControlValue = parseCacheControl(cacheControl);
-
-        // max-age and s-maxage are stored in
-        const maxAge = cacheControlValue['max-age'] || cacheControlValue['s-maxage'];
-        if (maxAge) {
-          // age is stored in seconds
-          const ageValue = parseInt(age, 10);
-          macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-            if (!test) {
-              throw new Error(`Invalid Cache-Control value, expected a number but got - ${age}`);
-            }
-          })(!Number.isNaN(ageValue)) : {};
-          macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-            if (!test) {
-              throw new Error(`Invalid Cache-Control value, expected a number greater than 0 but got - ${age}`);
-            }
-          })(ageValue >= 0) : {};
-          if (!Number.isNaN(ageValue) && ageValue >= 0) {
-            const dateValue = new Date(date).getTime();
-            const expirationTime = dateValue + (maxAge - ageValue) * 1000;
-            const result = now >= expirationTime;
-            if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-              if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-                // eslint-disable-next-line no-console
-                console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Cache-Control header is ${result ? 'in the past' : 'in the future'}`);
-              }
-            }
-            return result;
-          }
-        }
-      }
-    }
-
-    // check for Expires
-    if (constraints.headers.Expires) {
-      const expires = headers.get('Expires');
-      if (expires) {
-        const expirationTime = new Date(expires).getTime();
-        const result = now >= expirationTime;
-        if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-          if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-            // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Expires header is ${result ? 'in the past' : 'in the future'}`);
-          }
-        }
-        return result;
-      }
-    }
-  }
-
-  // check for Date
-  if (!date) {
-    if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-      if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-        // eslint-disable-next-line no-console
-        console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no Date header was provided`);
-      }
-    }
-    return true;
-  }
-  let expirationTime = config.apiCacheHardExpires;
-  if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
-    if (!config.disableTestOptimization) {
-      expirationTime = config.apiCacheSoftExpires;
-    }
-  }
-  const time = new Date(date).getTime();
-  const deadline = time + expirationTime;
-  const result = now >= deadline;
-  if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-    if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-      // eslint-disable-next-line no-console
-      console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the apiCacheHardExpires time since the response's Date header is ${result ? 'in the past' : 'in the future'}`);
-    }
-  }
-  return result;
-}
-
-/**
- * The configuration options for the {@link DefaultCachePolicy}
- *
- * ```ts
- * import { DefaultCachePolicy } from '@warp-drive/core/store';
- *
- * new DefaultCachePolicy({
- *   // ... PolicyConfig Settings ... //
- * });
- * ```
- *
- */
-
-/**
- * A basic CachePolicy that can be added to the Store service.
- *
- * Determines staleness based on time since the request was last received from the API
- * using the `date` header.
- *
- * Determines expiration based on configured constraints as well as a time based
- * expiration strategy based on the `date` header.
- *
- * In order expiration is determined by:
- *
- * - Is explicitly invalidated
- * -  ↳ (if null) isExpired function \<IF Constraint Active>
- * -  ↳ (if null) X-WarpDrive-Expires header \<IF Constraint Active>
- * -  ↳ (if null) Cache-Control header \<IF Constraint Active>
- * -  ↳ (if null) Expires header \<IF Constraint Active>
- * -  ↳ (if null) Date header + apiCacheHardExpires \< current time
- *
- * Invalidates any request for which `cacheOptions.types` was provided when a createRecord
- * request for that type is successful.
- *
- * For this to work, the `createRecord` request must include the `cacheOptions.types` array
- * with the types that should be invalidated, or its request should specify the ResourceKeys
- * of the records that are being created via `records`. Providing both is valid.
- *
- * > [!NOTE]
- * > only requests that had specified `cacheOptions.types` and occurred prior to the
- * > createRecord request will be invalidated. This means that a given request should always
- * > specify the types that would invalidate it to opt into this behavior. Abstracting this
- * > behavior via builders is recommended to ensure consistency.
- *
- * This allows the Store's CacheHandler to determine if a request is expired and
- * should be refetched upon next request.
- *
- * The `Fetch` handler provided by `@warp-drive/core` will automatically
- * add the `date` header to responses if it is not present.
- *
- * > [!NOTE]
- * > Date headers do not have millisecond precision, so expiration times should
- * > generally be larger than 1000ms.
- *
- * Usage:
- *
- * ```ts
- * import { Store } from '@warp-drive/core';
- * import { DefaultCachePolicy } from '@warp-drive/core/store';
- *
- * export class AppStore extends Store {
- *   lifetimes = new DefaultCachePolicy({
- *     apiCacheSoftExpires: 30_000,
- *     apiCacheHardExpires: 60_000
- *   });
- * }
- * ```
- *
- * In Testing environments, the `apiCacheSoftExpires` will always be `false`
- * and `apiCacheHardExpires` will use the `apiCacheSoftExpires` value.
- *
- * This helps reduce flakiness and produce predictably rendered results in test suites.
- *
- * Requests that specifically set `cacheOptions.backgroundReload = true` will
- * still be background reloaded in tests.
- *
- * This behavior can be opted out of by setting `disableTestOptimization = true`
- * in the policy config.
- *
- * @public
- */
-class DefaultCachePolicy {
-  _getStore(store) {
-    let set = this._stores.get(store);
-    if (!set) {
-      set = {
-        invalidated: new Set(),
-        types: new Map()
-      };
-      this._stores.set(store, set);
-    }
-    return set;
-  }
-  constructor(config) {
-    this._stores = new WeakMap();
-    const _config = arguments.length === 1 ? config : arguments[1];
-    deprecate(`Passing a Store to the CachePolicy is deprecated, please pass only a config instead.`, arguments.length === 1, {
-      id: 'ember-data:request-utils:lifetimes-service-store-arg',
-      since: {
-        enabled: '5.4',
-        available: '4.13'
-      },
-      for: '@ember-data/request-utils',
-      until: '6.0'
-    });
-    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-      if (!test) {
-        throw new Error(`You must pass a config to the CachePolicy`);
-      }
-    })(_config) : {};
-    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-      if (!test) {
-        throw new Error(`You must pass a apiCacheSoftExpires to the CachePolicy`);
-      }
-    })(typeof _config.apiCacheSoftExpires === 'number') : {};
-    macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
-      if (!test) {
-        throw new Error(`You must pass a apiCacheHardExpires to the CachePolicy`);
-      }
-    })(typeof _config.apiCacheHardExpires === 'number') : {};
-    this.config = _config;
-  }
-
-  /**
-   * Invalidate a request by its CacheKey for the given store instance.
-   *
-   * While the store argument may seem redundant, the CachePolicy
-   * is designed to be shared across multiple stores / forks
-   * of the store.
-   *
-   * ```ts
-   * store.lifetimes.invalidateRequest(store, cacheKey);
-   * ```
-   *
-   * @public
-   */
-  invalidateRequest(cacheKey, store) {
-    this._getStore(store).invalidated.add(cacheKey);
-  }
-
-  /**
-   * Invalidate all requests associated to a specific type
-   * for a given store instance.
-   *
-   * While the store argument may seem redundant, the CachePolicy
-   * is designed to be shared across multiple stores / forks
-   * of the store.
-   *
-   * This invalidation is done automatically when using this service
-   * for both the CacheHandler and the LegacyNetworkHandler.
-   *
-   * ```ts
-   * store.lifetimes.invalidateRequestsForType(store, 'person');
-   * ```
-   *
-   * @public
-   */
-  invalidateRequestsForType(type, store) {
-    const storeCache = this._getStore(store);
-    const set = storeCache.types.get(type);
-    const notifications = store.notifications;
-    if (set) {
-      // TODO batch notifications
-      set.forEach(id => {
-        storeCache.invalidated.add(id);
-        // @ts-expect-error
-        notifications.notify(id, 'invalidated', null);
-      });
-    }
-  }
-
-  /**
-   * Invoked when a request has been fulfilled from the configured request handlers.
-   * This is invoked by the CacheHandler for both foreground and background requests
-   * once the cache has been updated.
-   *
-   * Note, this is invoked by the CacheHandler regardless of whether
-   * the request has a cache-key.
-   *
-   * This method should not be invoked directly by consumers.
-   *
-   * @public
-   */
-  didRequest(request, response, cacheKey, store) {
-    // if this is a successful createRecord request, invalidate the cacheKey for the type
-    if (request.op === 'createRecord') {
-      const statusNumber = response?.status ?? 0;
-      if (statusNumber >= 200 && statusNumber < 400) {
-        const types = new Set(request.records?.map(r => r.type));
-        const additionalTypes = request.cacheOptions?.types;
-        additionalTypes?.forEach(type => {
-          types.add(type);
-        });
-        types.forEach(type => {
-          this.invalidateRequestsForType(type, store);
-        });
-      }
-
-      // add this document's cacheKey to a map for all associated types
-      // it is recommended to only use this for queries
-    } else if (cacheKey && request.cacheOptions?.types?.length) {
-      const storeCache = this._getStore(store);
-      request.cacheOptions?.types.forEach(type => {
-        const set = storeCache.types.get(type);
-        if (set) {
-          set.add(cacheKey);
-          storeCache.invalidated.delete(cacheKey);
-        } else {
-          storeCache.types.set(type, new Set([cacheKey]));
-        }
-      });
-    }
-  }
-
-  /**
-   * Invoked to determine if the request may be fulfilled from cache
-   * if possible.
-   *
-   * Note, this is only invoked by the CacheHandler if the request has
-   * a cache-key.
-   *
-   * If no cache entry is found or the entry is hard expired,
-   * the request will be fulfilled from the configured request handlers
-   * and the cache will be updated before returning the response.
-   *
-   * @public
-   * @return true if the request is considered hard expired
-   */
-  isHardExpired(cacheKey, store) {
-    // if we are explicitly invalidated, we are hard expired
-    const storeCache = this._getStore(store);
-    if (storeCache.invalidated.has(cacheKey)) {
-      return true;
-    }
-    const cache = store.cache;
-    const cached = cache.peekRequest(cacheKey);
-    if (!cached?.response) {
-      if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-        if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-          // eslint-disable-next-line no-console
-          console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no cache entry was found`);
-        }
-      }
-      return true;
-    }
-    return isExpired(cacheKey, cached, this.config);
-  }
-
-  /**
-   * Invoked if `isHardExpired` is false to determine if the request
-   * should be update behind the scenes if cache data is already available.
-   *
-   * Note, this is only invoked by the CacheHandler if the request has
-   * a cache-key.
-   *
-   * If true, the request will be fulfilled from cache while a backgrounded
-   * request is made to update the cache via the configured request handlers.
-   *
-   * @public
-   * @return true if the request is considered soft expired
-   */
-  isSoftExpired(cacheKey, store) {
-    if (macroCondition(getGlobalConfig().WarpDrive.env.TESTING)) {
-      if (!this.config.disableTestOptimization) {
-        return false;
-      }
-    }
-    const cache = store.cache;
-    const cached = cache.peekRequest(cacheKey);
-    if (cached?.response) {
-      const date = cached.response.headers.get('date');
-      if (!date) {
-        if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-          if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-            // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${cacheKey.lid} is STALE because no date header was found`);
-          }
-        }
-        return true;
-      } else {
-        const time = new Date(date).getTime();
-        const now = Date.now();
-        const deadline = time + this.config.apiCacheSoftExpires;
-        const result = now >= deadline;
-        if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-          if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-            // eslint-disable-next-line no-console
-            console.log(`CachePolicy: ${cacheKey.lid} is ${result ? 'STALE' : 'NOT stale'}. Expiration time: ${deadline}, now: ${now}`);
-          }
-        }
-        return result;
-      }
-    }
-    if (macroCondition(getGlobalConfig().WarpDrive.activeLogging.LOG_CACHE_POLICY)) {
-      if (getGlobalConfig().WarpDrive.debug.LOG_CACHE_POLICY || globalThis.getWarpDriveRuntimeConfig().debug.LOG_CACHE_POLICY) {
-        // eslint-disable-next-line no-console
-        console.log(`CachePolicy: ${cacheKey.lid} is STALE because no cache entry was found`);
-      }
-    }
-    return true;
-  }
-}
-export { DefaultCachePolicy, parseCacheControl };
+export { D as DefaultCachePolicy, p as parseCacheControl } from "./default-cache-policy-D7_u4YRH.js";

package/dist/types/-private.js

@@ -1,6 +1,6 @@
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 const name = "@warp-drive/core";
-const version = "5.8.0-alpha.4";
+const version = "5.8.0-alpha.6";
 
 // in testing mode, we utilize globals to ensure only one copy exists of
 // these maps, due to bugs in ember-auto-import

package/dist/types/request.js

@@ -8,7 +8,8 @@ const IS_FUTURE = getOrSetGlobal('IS_FUTURE', Symbol('IS_FUTURE'));
 const STRUCTURED = getOrSetGlobal('DOC', Symbol('DOC'));
 
 /**
- * Use these options to adjust CacheHandler behavior for a request.
+ * Use these options to adjust {@link CacheHandler} behavior for a request
+ * via {@link RequestInfo.cacheOptions}.
  *
  */
 

package/dist/types/schema/fields.js

@@ -443,6 +443,20 @@
  * @public
  */
 
+/**
+ * A trait for use on a PolarisMode record
+ */
+
+/**
+ * A trait for use on a LegacyMode record
+ */
+
+/**
+ * A union of
+ * - {@link LegacyTrait}
+ * - {@link PolarisTrait}
+ */
+
 /**
  * A no-op type utility that enables type-checking resource schema
  * definitions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warp-drive/core",
-  "version": "5.8.0-alpha.4",
+  "version": "5.8.0-alpha.6",
   "description": "Core package for WarpDrive | All the Universal Basics",
   "keywords": [
     "ember-addon"
@@ -37,13 +37,13 @@
   },
   "dependencies": {
     "@embroider/macros": "^1.18.1",
-    "@warp-drive/build-config": "5.8.0-alpha.4"
+    "@warp-drive/build-config": "5.8.0-alpha.6"
   },
   "devDependencies": {
     "@babel/core": "^7.28.3",
     "@babel/plugin-transform-typescript": "^7.28.0",
     "@babel/preset-typescript": "^7.27.1",
-    "@warp-drive/internal-config": "5.8.0-alpha.4",
+    "@warp-drive/internal-config": "5.8.0-alpha.6",
     "decorator-transforms": "^2.3.0",
     "ember-source": "~6.6.0",
     "expect-type": "^1.2.2",