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

package/dist/store/-private.d.ts

@@ -1,2 +1,2 @@
-import { $ as PrivateRequestStateService, B as logGroup, Dt as StoreRequestContext, Et as CacheHandler, G as ensureStringId, H as createLegacyManyArray, J as PrivateStore, K as constructResource, Ot as StoreRequestInput, Q as FindRecordQuery, Tt as CachePolicy, U as normalizeModelName, V as LegacyManyArray, W as coerceId, X as assertPrivateStore, Y as Store, Z as isPrivateStore, _t as recordIdentifierFor, at as fastPush, bn as isResourceKey, bt as PrivateCacheCapabilitiesManager, ct as PrivateReactiveResourceArray, et as Request, gt as _clearCaches, ht as StoreMap, it as RecordArrayManager, lt as ReactiveResourceArray, mt as InstanceCache, nt as RequestStateService, ot as LegacyQueryArray, pt as NativeProxy, q as CreateRecordProperties, rt as SaveRecordMutation, st as LegacyLiveArray, tt as RequestCacheRequestState, vt as setRecordIdentifier, xt as assertPrivateCapabilities, yn as isRequestKey, yt as storeFor, z as log } from "../internal-BrqYbG_y.js";
-export { CacheHandler, type CachePolicy, type LegacyQueryArray as CollectionRecordArray, type LegacyQueryArray, type CreateRecordProperties, type FindRecordQuery, type InstanceCache, type LegacyLiveArray, type LegacyLiveArray as LiveArray, type LegacyManyArray, type LegacyManyArray as RelatedCollection, type NativeProxy, type PrivateCacheCapabilitiesManager, type PrivateReactiveResourceArray, type PrivateRequestStateService, type PrivateStore, type ReactiveResourceArray, RecordArrayManager, type Request, type RequestCacheRequestState, type RequestStateService, type SaveRecordMutation, Store, StoreMap, type StoreRequestContext, type StoreRequestInput, _clearCaches, normalizeModelName as _deprecatingNormalize, assertPrivateCapabilities, assertPrivateStore, coerceId, constructResource, createLegacyManyArray, ensureStringId, fastPush, isPrivateStore, isRequestKey, isResourceKey, log, logGroup, recordIdentifierFor, setRecordIdentifier, storeFor };
+import { $ as PrivateStore, At as CachePolicy, Ct as setRecordIdentifier, Et as assertPrivateCapabilities, G as logGroup, J as normalizeModelName, K as LegacyManyArray, Mt as StoreRequestContext, Nt as StoreRequestInput, Q as CreateRecordProperties, St as recordIdentifierFor, Tt as PrivateCacheCapabilitiesManager, W as log, X as ensureStringId, Y as coerceId, Z as constructResource, at as Request, bt as StoreMap, cn as isRequestKey, ct as SaveRecordMutation, dt as LegacyQueryArray, et as Store, ft as LegacyLiveArray, it as PrivateRequestStateService, jt as CacheHandler, ln as isResourceKey, lt as RecordArrayManager, mt as ReactiveResourceArray, nt as isPrivateStore, on as FieldValueIdentity, ot as RequestCacheRequestState, pt as PrivateReactiveResourceArray, q as createLegacyManyArray, rt as FindRecordQuery, sn as fieldValueIdentity, st as RequestStateService, tt as assertPrivateStore, ut as fastPush, vt as NativeProxy, wt as storeFor, xt as _clearCaches, yt as InstanceCache } from "../internal-D_WIXC4r.js";
+export { CacheHandler, type CachePolicy, type LegacyQueryArray as CollectionRecordArray, type LegacyQueryArray, type CreateRecordProperties, type FieldValueIdentity, type FindRecordQuery, type InstanceCache, type LegacyLiveArray, type LegacyLiveArray as LiveArray, type LegacyManyArray, type LegacyManyArray as RelatedCollection, type NativeProxy, type PrivateCacheCapabilitiesManager, type PrivateReactiveResourceArray, type PrivateRequestStateService, type PrivateStore, type ReactiveResourceArray, RecordArrayManager, type Request, type RequestCacheRequestState, type RequestStateService, type SaveRecordMutation, Store, StoreMap, type StoreRequestContext, type StoreRequestInput, _clearCaches, normalizeModelName as _deprecatingNormalize, assertPrivateCapabilities, assertPrivateStore, coerceId, constructResource, createLegacyManyArray, ensureStringId, fastPush, fieldValueIdentity, isPrivateStore, isRequestKey, isResourceKey, log, logGroup, recordIdentifierFor, setRecordIdentifier, storeFor };

package/dist/store/-private.js

@@ -1,3 +1,3 @@
-import { C as setRecordIdentifier, D as isResourceKey, E as isRequestKey, F as ensureStringId, I as log, L as logGroup, N as normalizeModelName, P as coerceId, S as recordIdentifierFor, T as assertPrivateCapabilities, _ as isPrivateStore, b as StoreMap, f as createLegacyManyArray, g as assertPrivateStore, h as Store, m as CacheHandler, p as constructResource, v as RecordArrayManager, w as storeFor, x as _clearCaches, y as fastPush } from "../src-C-xK8l3f.js";
+import { C as setRecordIdentifier, D as isRequestKey, E as fieldValueIdentity, F as coerceId, I as ensureStringId, L as log, O as isResourceKey, P as normalizeModelName, R as logGroup, S as recordIdentifierFor, T as assertPrivateCapabilities, _ as isPrivateStore, b as StoreMap, f as createLegacyManyArray, g as assertPrivateStore, h as Store, m as CacheHandler, p as constructResource, v as RecordArrayManager, w as storeFor, x as _clearCaches, y as fastPush } from "../src-ccp1WKyt.js";
 
-export { CacheHandler, RecordArrayManager, Store, StoreMap, _clearCaches, normalizeModelName as _deprecatingNormalize, assertPrivateCapabilities, assertPrivateStore, coerceId, constructResource, createLegacyManyArray, ensureStringId, fastPush, isPrivateStore, isRequestKey, isResourceKey, log, logGroup, recordIdentifierFor, setRecordIdentifier, storeFor };
+export { CacheHandler, RecordArrayManager, Store, StoreMap, _clearCaches, normalizeModelName as _deprecatingNormalize, assertPrivateCapabilities, assertPrivateStore, coerceId, constructResource, createLegacyManyArray, ensureStringId, fastPush, fieldValueIdentity, isPrivateStore, isRequestKey, isResourceKey, log, logGroup, recordIdentifierFor, setRecordIdentifier, storeFor };

package/dist/{store-DNF9Rgoh.js → store-C8iKKtQK.js}

@@ -2,11 +2,14 @@ import { LRUCache } from "./utils/string.js";
 import { getGlobalConfig, macroCondition } from "@embroider/macros";
 import { deprecate } from "@ember/debug";
 
-//#region src/store/-private/default-cache-policy.ts
+// src/store/-private/default-cache-policy.ts
 /**
 * Interface of a parsed Cache-Control header value.
 *
 * - [MDN Cache-Control Reference](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control)
+*
+* @summary The directives of a `Cache-Control` header as an object of flags and second counts, as
+* returned by `parseCacheControl`.
 */
 const NUMERIC_KEYS = /* @__PURE__ */ new Set([
 	"max-age",
@@ -38,6 +41,8 @@ const NUMERIC_KEYS = /* @__PURE__ */ new Set([
 *
 * See also {@link CacheControlValue} and [Response Directives](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control#response_directives)
 *
+* @summary Parses a `Cache-Control` header string into a `CacheControlValue` object, caching results
+* per header string.
 * @public
 */
 function parseCacheControl(header) {
@@ -173,6 +178,9 @@ function isExpired(cacheKey, request, config) {
 /**
 * The configuration options for the {@link DefaultCachePolicy}
 *
+* The [Advanced Store Configuration](/guides/configuration/advanced#decide-how-long-requests-are-valid-for-with-a-cachepolicy)
+* guide shows a policy configured with them.
+*
 * ```ts [app/services/store.ts]
 * import { Store } from '@warp-drive-mirror/core';
 * import { DefaultCachePolicy } from '@warp-drive-mirror/core/store'; // [!code focus]
@@ -184,10 +192,15 @@ function isExpired(cacheKey, request, config) {
 * }
 * ```
 *
+* @summary Options for `DefaultCachePolicy`: soft and hard expiration times, header-based expiration
+* constraints, and test-mode behavior.
 */
 /**
 * A basic {@link CachePolicy} that can be added to the Store service.
 *
+* The [Advanced Store Configuration](/guides/configuration/advanced#decide-how-long-requests-are-valid-for-with-a-cachepolicy)
+* guide shows how to configure it.
+*
 * ```ts [app/services/store.ts]
 * import { Store } from '@warp-drive-mirror/core';
 * import { DefaultCachePolicy } from '@warp-drive-mirror/core/store'; // [!code focus]
@@ -266,6 +279,8 @@ function isExpired(cacheKey, request, config) {
 * This behavior can be opted out of by setting `disableTestOptimization = true`
 * in the policy config.
 *
+* @summary The built-in cache policy, which expires cached requests using expiration headers or time
+* since the response `date`, and invalidates queries after matching creates.
 * @public
 */
 var DefaultCachePolicy = class {
@@ -457,6 +472,5 @@ var DefaultCachePolicy = class {
 	}
 };
 
-//#endregion
 export { parseCacheControl as n, DefaultCachePolicy as t };
-//# sourceMappingURL=store-DNF9Rgoh.js.map
+//# sourceMappingURL=store-C8iKKtQK.js.map

package/dist/store-C8iKKtQK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-C8iKKtQK.js","names":["deprecate","LRUCache","getGlobalConfig","macroCondition","NUMERIC_KEYS","Set","parseCacheControl","header","CACHE_CONTROL_CACHE","get","key","value","isParsingKey","cacheControlValue","i","length","char","charAt","WarpDrive","env","DEBUG","test","Error","has","parseCacheControlValue","stringToParse","parsedValue","Number","parseInt","isNaN","isExpired","cacheKey","request","config","constraints","result","activeLogging","LOG_CACHE_POLICY","debug","globalThis","getWarpDriveRuntimeConfig","console","log","lid","headers","response","now","Date","date","xWarpDriveExpires","expirationTime","getTime","cacheControl","age","maxAge","ageValue","dateValue","Expires","expires","apiCacheHardExpires","TESTING","disableTestOptimization","apiCacheSoftExpires","time","deadline","DefaultCachePolicy","_getStore","store","set","_stores","invalidated","types","Map","constructor","WeakMap","_config","arguments","id","since","enabled","available","for","until","invalidateRequest","add","invalidateRequestsForType","type","storeCache","notifications","forEach","notify","didRequest","op","statusNumber","status","records","map","r","additionalTypes","cacheOptions","delete","isHardExpired","cache","cached","peekRequest","isSoftExpired"],"sources":["../src/store/-private/default-cache-policy.ts"],"sourcesContent":["import { deprecate } from '@ember/debug';\n\nimport { LOG_CACHE_POLICY } from '@warp-drive-mirror/core/build-config/debugging';\nimport { TESTING } from '@warp-drive-mirror/core/build-config/env';\nimport { assert } from '@warp-drive-mirror/core/build-config/macros';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { CacheHandler, CachePolicy } from '../-private';\n// oxlint-disable-next-line no-unused-vars\nimport type { Fetch } from '../../request/-private/fetch';\nimport type { Cache } from '../../types/cache';\nimport type { RequestKey, ResourceKey } from '../../types/identifier';\nimport type {\n  // oxlint-disable-next-line no-unused-vars\n  CacheOptions,\n  ImmutableRequestInfo,\n  // oxlint-disable-next-line no-unused-vars\n  RequestInfo,\n  ResponseInfo,\n  StructuredDocument,\n} from '../../types/request';\nimport type { ResourceDocument } from '../../types/spec/document';\nimport { LRUCache } from '../../utils/string';\n\ntype UnsubscribeToken = object;\ntype CacheOperation = 'added' | 'removed' | 'updated' | 'state';\ntype DocumentCacheOperation = 'invalidated' | 'added' | 'removed' | 'updated' | 'state';\n\nexport interface NotificationCallback {\n  (resourceKey: ResourceKey, notificationType: 'attributes' | 'relationships', key?: string): void;\n  (resourceKey: ResourceKey, notificationType: 'errors' | 'meta' | 'identity' | 'state'): void;\n  // (resourceKey: ResourceKey, notificationType: NotificationType, key?: string): void;\n}\n\ninterface ResourceOperationCallback {\n  // resource updates\n  (resourceKey: ResourceKey, notificationType: CacheOperation): void;\n}\n\ninterface DocumentOperationCallback {\n  // document updates\n  (cacheKey: RequestKey, notificationType: DocumentCacheOperation): void;\n}\n\ntype NotificationManager = {\n  subscribe(resourceKey: ResourceKey, callback: NotificationCallback): UnsubscribeToken;\n  subscribe(cacheKey: 'resource', callback: ResourceOperationCallback): UnsubscribeToken;\n  subscribe(cacheKey: 'document' | RequestKey, callback: DocumentOperationCallback): UnsubscribeToken;\n\n  notify(cacheKey: ResourceKey, value: 'attributes' | 'relationships', key?: string): boolean;\n  notify(cacheKey: ResourceKey, value: 'errors' | 'meta' | 'identity' | 'state'): boolean;\n  notify(cacheKey: ResourceKey, value: CacheOperation): boolean;\n  notify(cacheKey: RequestKey, value: DocumentCacheOperation): boolean;\n};\n\ntype Store = {\n  cache: Cache;\n  notifications: NotificationManager;\n};\n\n/**\n * Interface of a parsed Cache-Control header value.\n *\n * - [MDN Cache-Control Reference](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control)\n *\n * @summary The directives of a `Cache-Control` header as an object of flags and second counts, as\n * returned by `parseCacheControl`.\n */\nexport interface CacheControlValue {\n  /** Indicates the response will never change; parsed but not currently used by this cache policy's expiration logic. */\n  immutable?: boolean;\n  /** Seconds since the response's `Date` that it is considered fresh; combined with the `Age` header to determine expiration. */\n  'max-age'?: number;\n  /** Indicates a stale response must be revalidated before use; parsed but not currently used by this cache policy's expiration logic. */\n  'must-revalidate'?: boolean;\n  /** Indicates the client must understand the response's status code semantics before caching; parsed but not currently used by this cache policy's expiration logic. */\n  'must-understand'?: boolean;\n  /** Indicates the response must be revalidated before being reused from cache; parsed but not currently used by this cache policy's expiration logic. */\n  'no-cache'?: boolean;\n  /** Indicates the response must not be stored in any cache; parsed but not currently used by this cache policy's expiration logic. */\n  'no-store'?: boolean;\n  /** Indicates the response must not be transformed by intermediaries; parsed but not currently used by this cache policy's expiration logic. */\n  'no-transform'?: boolean;\n  /** Indicates only an already-cached response should be used; parsed but not currently used by this cache policy's expiration logic. */\n  'only-if-cached'?: boolean;\n  /** Indicates the response is intended for a single user and should not be stored by shared caches; parsed but not currently used by this cache policy's expiration logic. */\n  private?: boolean;\n  /** Like `must-revalidate` but only for shared caches; parsed but not currently used by this cache policy's expiration logic. */\n  'proxy-revalidate'?: boolean;\n  /** Indicates the response may be stored by any cache; parsed but not currently used by this cache policy's expiration logic. */\n  public?: boolean;\n  /** Seconds since the response's `Date` that it is considered fresh for shared caches; used as a fallback for `max-age` when determining expiration. */\n  's-maxage'?: number;\n  /** Seconds a stale response may be reused if an error occurs while revalidating; parsed but not currently used by this cache policy's expiration logic. */\n  'stale-if-error'?: number;\n  /** Seconds a stale response may be reused while a revalidation happens in the background; parsed but not currently used by this cache policy's expiration logic. */\n  'stale-while-revalidate'?: number;\n}\n\ntype CacheControlKey = keyof CacheControlValue;\n\nconst NUMERIC_KEYS = new Set(['max-age', 's-maxage', 'stale-if-error', 'stale-while-revalidate']);\n\n/**\n *  Parses a string Cache-Control header value into an object with the following structure:\n *\n * ```ts\n * interface CacheControlValue {\n *   immutable?: boolean;\n *   'max-age'?: number;\n *   'must-revalidate'?: boolean;\n *   'must-understand'?: boolean;\n *   'no-cache'?: boolean;\n *   'no-store'?: boolean;\n *   'no-transform'?: boolean;\n *   'only-if-cached'?: boolean;\n *   private?: boolean;\n *   'proxy-revalidate'?: boolean;\n *   public?: boolean;\n *   's-maxage'?: number;\n *   'stale-if-error'?: number;\n *   'stale-while-revalidate'?: number;\n * }\n * ```\n *\n * See also {@link CacheControlValue} and [Response Directives](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control#response_directives)\n *\n * @summary Parses a `Cache-Control` header string into a `CacheControlValue` object, caching results\n * per header string.\n * @public\n */\nexport function parseCacheControl(header: string): CacheControlValue {\n  return CACHE_CONTROL_CACHE.get(header);\n}\n\nconst CACHE_CONTROL_CACHE = new LRUCache((header: string) => {\n  let key: CacheControlKey = '' as CacheControlKey;\n  let value = '';\n  let isParsingKey = true;\n  const cacheControlValue: CacheControlValue = {};\n\n  for (let i = 0; i < header.length; i++) {\n    const char = header.charAt(i);\n    if (char === ',') {\n      assert(`Invalid Cache-Control value, expected a value`, !isParsingKey || !NUMERIC_KEYS.has(key));\n      assert(\n        `Invalid Cache-Control value, expected a value after \"=\" but got \",\"`,\n        i === 0 || header.charAt(i - 1) !== '='\n      );\n      isParsingKey = true;\n      // @ts-expect-error TS incorrectly thinks that optional keys must have a type that includes undefined\n      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? parseCacheControlValue(value) : true;\n      key = '' as CacheControlKey;\n      value = '';\n      continue;\n    } else if (char === '=') {\n      assert(`Invalid Cache-Control value, expected a value after \"=\"`, i + 1 !== header.length);\n      isParsingKey = false;\n    } else if (char === ' ' || char === `\\t` || char === `\\n`) {\n      continue;\n    } else if (isParsingKey) {\n      key += char;\n    } else {\n      value += char;\n    }\n\n    if (i === header.length - 1) {\n      // @ts-expect-error TS incorrectly thinks that optional keys must have a type that includes undefined\n      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? parseCacheControlValue(value) : true;\n    }\n  }\n\n  return cacheControlValue;\n}, 200);\n\nfunction parseCacheControlValue(stringToParse: string): number {\n  const parsedValue = Number.parseInt(stringToParse);\n  assert(`Invalid Cache-Control value, expected a number but got - ${stringToParse}`, !Number.isNaN(parsedValue));\n  assert(`Invalid Cache-Control value, expected a number greater than 0 but got - ${stringToParse}`, parsedValue >= 0);\n  if (Number.isNaN(parsedValue) || parsedValue < 0) {\n    return 0;\n  }\n\n  return parsedValue;\n}\n\nfunction isExpired(cacheKey: RequestKey, request: StructuredDocument<ResourceDocument>, config: PolicyConfig): boolean {\n  const { constraints } = config;\n\n  if (constraints?.isExpired) {\n    const result = constraints.isExpired(request);\n    if (result !== null) {\n      if (LOG_CACHE_POLICY) {\n        // oxlint-disable-next-line no-console\n        console.log(\n          `CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because constraints.isExpired returned ${result}`\n        );\n      }\n      return result;\n    }\n  }\n\n  const { headers } = request.response!;\n\n  if (!headers) {\n    if (LOG_CACHE_POLICY) {\n      // oxlint-disable-next-line no-console\n      console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no headers were provided`);\n    }\n\n    // if we have no headers then both the headers based expiration\n    // and the time based expiration will be considered expired\n    return true;\n  }\n\n  // check for X-WarpDrive-Expires\n  const now = Date.now();\n  const date = headers.get('Date');\n\n  if (constraints?.headers) {\n    if (constraints.headers['X-WarpDrive-Expires']) {\n      const xWarpDriveExpires = headers.get('X-WarpDrive-Expires');\n      if (xWarpDriveExpires) {\n        const expirationTime = new Date(xWarpDriveExpires).getTime();\n        const result = now >= expirationTime;\n        if (LOG_CACHE_POLICY) {\n          // oxlint-disable-next-line no-console\n          console.log(\n            `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'}`\n          );\n        }\n        return result;\n      }\n    }\n\n    // check for Cache-Control\n    if (constraints.headers['Cache-Control']) {\n      const cacheControl = headers.get('Cache-Control');\n      const age = headers.get('Age');\n\n      if (cacheControl && age && date) {\n        const cacheControlValue = parseCacheControl(cacheControl);\n\n        // max-age and s-maxage are stored in\n        const maxAge = cacheControlValue['max-age'] || cacheControlValue['s-maxage'];\n\n        if (maxAge) {\n          // age is stored in seconds\n          const ageValue = parseInt(age, 10);\n          assert(`Invalid Cache-Control value, expected a number but got - ${age}`, !Number.isNaN(ageValue));\n          assert(`Invalid Cache-Control value, expected a number greater than 0 but got - ${age}`, ageValue >= 0);\n\n          if (!Number.isNaN(ageValue) && ageValue >= 0) {\n            const dateValue = new Date(date).getTime();\n            const expirationTime = dateValue + (maxAge - ageValue) * 1000;\n            const result = now >= expirationTime;\n\n            if (LOG_CACHE_POLICY) {\n              // oxlint-disable-next-line no-console\n              console.log(\n                `CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Cache-Control header is ${result ? 'in the past' : 'in the future'}`\n              );\n            }\n\n            return result;\n          }\n        }\n      }\n    }\n\n    // check for Expires\n    if (constraints.headers.Expires) {\n      const expires = headers.get('Expires');\n      if (expires) {\n        const expirationTime = new Date(expires).getTime();\n        const result = now >= expirationTime;\n        if (LOG_CACHE_POLICY) {\n          // oxlint-disable-next-line no-console\n          console.log(\n            `CachePolicy: ${cacheKey.lid} is ${result ? 'EXPIRED' : 'NOT expired'} because the time set by Expires header is ${result ? 'in the past' : 'in the future'}`\n          );\n        }\n        return result;\n      }\n    }\n  }\n\n  // check for Date\n  if (!date) {\n    if (LOG_CACHE_POLICY) {\n      // oxlint-disable-next-line no-console\n      console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no Date header was provided`);\n    }\n    return true;\n  }\n\n  let expirationTime = config.apiCacheHardExpires;\n  if (TESTING) {\n    if (!config.disableTestOptimization) {\n      expirationTime = config.apiCacheSoftExpires;\n    }\n  }\n\n  const time = new Date(date).getTime();\n  const deadline = time + expirationTime;\n  const result = now >= deadline;\n\n  if (LOG_CACHE_POLICY) {\n    // oxlint-disable-next-line no-console\n    console.log(\n      `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'}`\n    );\n  }\n\n  return result;\n}\n\n/**\n * The constraint options for {@link PolicyConfig.constraints}\n */\nexport interface PolicyConfigConstraints {\n  /**\n   * Headers that should be checked for expiration.\n   *\n   */\n  headers?: {\n    /**\n     * Whether the `Cache-Control` header should be checked for expiration.\n     * If `true`, then the `max-age` and `s-maxage` directives are used alongside\n     * the `Age` and `Date` headers to determine if the expiration time has passed.\n     *\n     * Other directives are ignored.\n     *\n     * 'Cache-Control' will take precedence over 'Expires' if both are present\n     * and both configured to be checked.\n     *\n     */\n    'Cache-Control'?: boolean;\n\n    /**\n     * Whether the `Expires` header should be checked for expiration.\n     *\n     * If `true`, then the `Expires` header is used to caclulate the expiration time\n     * and determine if the expiration time has passed.\n     *\n     * 'Cache-Control' will take precedence over 'Expires' if both are present.\n     *\n     */\n    Expires?: boolean;\n\n    /**\n     * Whether the `X-WarpDrive-Expires` header should be checked for expiration.\n     *\n     * If `true`, then the `X-WarpDrive-Expires` header is used to caclulate the expiration time\n     * and determine if the expiration time has passed.\n     *\n     * This header will take precedence over 'Cache-Control' and 'Expires' if all three are present.\n     *\n     * The header's value should be a [UTC date string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toUTCString).\n     *\n     */\n    'X-WarpDrive-Expires'?: boolean;\n  };\n\n  /**\n   * A function that should be called to determine if the request is expired.\n   *\n   * If present, this function will be called with the request and should return\n   * `true` if the request is expired, `false` if it is not expired, and\n   * `null` if the expiration status is unknown.\n   *\n   * If the function does not return `null`,\n   *\n   */\n  isExpired?: (request: StructuredDocument<ResourceDocument>) => boolean | null;\n}\n\n/**\n * The configuration options for the {@link DefaultCachePolicy}\n *\n * The [Advanced Store Configuration](/guides/configuration/advanced#decide-how-long-requests-are-valid-for-with-a-cachepolicy)\n * guide shows a policy configured with them.\n *\n * ```ts [app/services/store.ts]\n * import { Store } from '@warp-drive-mirror/core';\n * import { DefaultCachePolicy } from '@warp-drive-mirror/core/store'; // [!code focus]\n *\n * export default class AppStore extends Store {\n *   lifetimes = new DefaultCachePolicy({ // [!code focus:3]\n *     // ... PolicyConfig Settings ... //\n *   });\n * }\n * ```\n *\n * @summary Options for `DefaultCachePolicy`: soft and hard expiration times, header-based expiration\n * constraints, and test-mode behavior.\n */\nexport interface PolicyConfig {\n  /**\n   * the number of milliseconds after which a request is considered\n   * stale. If a request is issued again after this time, the request\n   * will respond from cache immediately while a background request\n   * is made to update the cache.\n   *\n   * This is calculated against the `date` header of the response.\n   *\n   * If your API does not provide a `date` header, the {@link Fetch} handler\n   * will automatically add it to responses if it is not present. Responses\n   * without a `date` header will be considered stale immediately.\n   *\n   */\n  apiCacheSoftExpires: number;\n  /**\n   * the number of milliseconds after which a request is considered\n   * expired and should be re-fetched. If a request is issued again\n   * after this time, the request will disregard the cache and\n   * wait for a fresh response from the API.\n   *\n   * This is calculated against the `date` header of the response.\n   *\n   * If your API does not provide a `date` header, the {@link Fetch} handler\n   * will automatically add it to responses if it is not present. Responses\n   * without a `date` header will be considered hard expired immediately.\n   *\n   */\n  apiCacheHardExpires: number;\n  /**\n   * In Testing environments, the `apiCacheSoftExpires` will always be `false`\n   * and `apiCacheHardExpires` will use the `apiCacheSoftExpires` value.\n   *\n   * This helps reduce flakiness and produce predictably rendered results in test suites.\n   *\n   * Requests that specifically set {@link RequestInfo.cacheOptions.backgroundReload | cacheOptions.backgroundReload }\n   * will still be background reloaded in tests.\n   *\n   * This behavior can be opted out of by setting this value to `true`.\n   *\n   */\n  disableTestOptimization?: boolean;\n\n  /**\n   * In addition to the simple time-based expiration strategy, CachePolicy\n   * supports various common server-supplied expiration strategies via\n   * headers, as well as custom expiration strategies via the {@link PolicyConfigConstraints.isExpired | isExpired}\n   * function.\n   *\n   * Requests will be validated for expiration against these constraints.\n   * If any of these constraints are not met, the request will be considered\n   * expired. If all constraints are met, the request will be considered\n   * valid and the time based expiration strategy will NOT be used.\n   *\n   * Meeting a constraint means BOTH that the properties the constraint\n   * requires are present AND that the expiration time indicated by those\n   * properties has not been exceeded.\n   *\n   * In other words, if the properties for a constraint are not present,\n   * this does not count either as meeting or as not meeting the constraint,\n   * the constraint simply does not apply.\n   *\n   * The `isExpired` function is called with the request and should return\n   * `true` if the request is expired, `false` if it is not expired, and\n   * `null` if the expiration status is unknown.\n   *\n   * In order constraints are checked:\n   *\n   * - isExpired function\n   * -  ↳ (if null) X-WarpDrive-Expires header\n   * -  ↳ (if null) Cache-Control header\n   * -  ↳ (if null) Expires header\n   *\n   * See {@link PolicyConfigConstraints} for configuration options.\n   */\n  constraints?: PolicyConfigConstraints;\n}\n\n/**\n * A basic {@link CachePolicy} that can be added to the Store service.\n *\n * The [Advanced Store Configuration](/guides/configuration/advanced#decide-how-long-requests-are-valid-for-with-a-cachepolicy)\n * guide shows how to configure it.\n *\n * ```ts [app/services/store.ts]\n * import { Store } from '@warp-drive-mirror/core';\n * import { DefaultCachePolicy } from '@warp-drive-mirror/core/store'; // [!code focus]\n *\n * export default class AppStore extends Store {\n *   lifetimes = new DefaultCachePolicy({ // [!code focus:5]\n *     apiCacheSoftExpires: 30_000,\n *     apiCacheHardExpires: 60_000,\n *     // ... Other PolicyConfig Settings ... //\n *   });\n * }\n * ```\n *\n * :::tip 💡 TIP\n * Date headers do not have millisecond precision, so expiration times should\n * generally be larger than 1000ms.\n * :::\n *\n * See also {@link PolicyConfig} for configuration options.\n *\n * ### The Mechanics\n *\n * This policy determines staleness based on various configurable constraints falling back to a simple\n * check of the time elapsed since the request was last received from the API using the `date` header\n * from the last response.\n *\n * :::tip 💡 TIP\n * The {@link Fetch} handler provided by `@warp-drive-mirror/core` will automatically\n * add the `date` header to responses if it is not present.\n * :::\n *\n * - For manual override of reload see {@link CacheOptions.reload | cacheOptions.reload}\n * - For manual override of background reload see {@link CacheOptions.backgroundReload | cacheOptions.backgroundReload}\n *\n * In order expiration is determined by:\n *\n * ```md\n * Is explicitly invalidated by `cacheOptions.reload`\n *   ↳ (if falsey) if the request has been explicitly invalidated\n *      since the last request (see Automatic Invalidation below)\n *   ↳ (if false) (If Active) isExpired function\n *   ↳ (if null) (If Active) X-WarpDrive-Expires header\n *   ↳ (if null) (If Active) Cache-Control header\n *   ↳ (if null) (If Active) Expires header\n *   ↳ (if null) Date header + apiCacheHardExpires < current time\n *\n *   -- <if above is false, a background request is issued if> --\n *\n *   ↳ is invalidated by `cacheOptions.backgroundReload`\n *   ↳ (if falsey) Date header + apiCacheSoftExpires < current time\n * ```\n *\n * ### Automatic Invalidation / Entanglement\n *\n * It also invalidates any request with an {@link RequestInfo.op | OpCode} of `\"query\"`\n * for which {@link CacheOptions.types | cacheOptions.types} was provided\n * when a request with an `OpCode` of `\"createRecord\"` is successful and also includes\n * a matching type in its own `cacheOptions.types` array.\n\n * :::tip 💡 TIP\n * Abstracting this behavior via builders is recommended to ensure consistency.\n * :::\n *\n * ### Testing\n *\n * In Testing environments:\n *\n * - `apiCacheSoftExpires` will always be `false`\n * - `apiCacheHardExpires` will use the `apiCacheSoftExpires` value.\n *\n * This helps reduce flakiness and produce predictably rendered results in test suites.\n *\n * Requests that specifically set `cacheOptions.backgroundReload = true` will\n * still be background reloaded in tests.\n *\n * This behavior can be opted out of by setting `disableTestOptimization = true`\n * in the policy config.\n *\n * @summary The built-in cache policy, which expires cached requests using expiration headers or time\n * since the response `date`, and invalidates queries after matching creates.\n * @public\n */\nexport class DefaultCachePolicy implements CachePolicy {\n  /**\n   * @internal\n   */\n  declare private config: PolicyConfig;\n  /**\n   * @internal\n   */\n  declare private _stores: WeakMap<Store, { invalidated: Set<RequestKey>; types: Map<string, Set<RequestKey>> }>;\n\n  /**\n   * @internal\n   */\n  private _getStore(store: Store): {\n    invalidated: Set<RequestKey>;\n    types: Map<string, Set<RequestKey>>;\n  } {\n    let set = this._stores.get(store);\n    if (!set) {\n      set = { invalidated: new Set(), types: new Map() };\n      this._stores.set(store, set);\n    }\n    return set;\n  }\n\n  constructor(config: PolicyConfig) {\n    this._stores = new WeakMap();\n\n    const _config = arguments.length === 1 ? config : (arguments[1] as unknown as PolicyConfig);\n    deprecate(\n      `Passing a Store to the CachePolicy is deprecated, please pass only a config instead.`,\n      arguments.length === 1,\n      {\n        id: 'ember-data-mirror:request-utils:lifetimes-service-store-arg',\n        since: {\n          enabled: '5.4',\n          available: '4.13',\n        },\n        for: '@ember-data-mirror/request-utils',\n        until: '6.0',\n      }\n    );\n    assert(`You must pass a config to the CachePolicy`, _config);\n    assert(`You must pass a apiCacheSoftExpires to the CachePolicy`, typeof _config.apiCacheSoftExpires === 'number');\n    assert(`You must pass a apiCacheHardExpires to the CachePolicy`, typeof _config.apiCacheHardExpires === 'number');\n    this.config = _config;\n  }\n\n  /**\n   * Invalidate a request by its CacheKey for the given store instance.\n   *\n   * While the store argument may seem redundant, the CachePolicy\n   * is designed to be shared across multiple stores / forks\n   * of the store.\n   *\n   * ```ts\n   * store.lifetimes.invalidateRequest(store, cacheKey);\n   * ```\n   *\n   * @public\n   */\n  invalidateRequest(cacheKey: RequestKey, store: Store): void {\n    this._getStore(store).invalidated.add(cacheKey);\n  }\n\n  /**\n   * Invalidate all requests associated to a specific type\n   * for a given store instance.\n   *\n   * While the store argument may seem redundant, the CachePolicy\n   * is designed to be shared across multiple stores / forks\n   * of the store.\n   *\n   * This invalidation is done automatically when using this service\n   * for both the {@link CacheHandler} and the [NetworkHandler](/api/@warp-drive-mirror/legacy/compat/variables/LegacyNetworkHandler).\n   *\n   * ```ts\n   * store.lifetimes.invalidateRequestsForType(store, 'person');\n   * ```\n   *\n   * @public\n   */\n  invalidateRequestsForType(type: string, store: Store): void {\n    const storeCache = this._getStore(store);\n    const set = storeCache.types.get(type);\n    const notifications = store.notifications;\n\n    if (set) {\n      // TODO batch notifications\n      set.forEach((id) => {\n        storeCache.invalidated.add(id);\n        // @ts-expect-error\n        notifications.notify(id, 'invalidated', null);\n      });\n    }\n  }\n\n  /**\n   * Invoked when a request has been fulfilled from the configured request handlers.\n   * This is invoked by the CacheHandler for both foreground and background requests\n   * once the cache has been updated.\n   *\n   * Note, this is invoked by the {@link CacheHandler} regardless of whether\n   * the request has a cache-key.\n   *\n   * This method should not be invoked directly by consumers.\n   *\n   * @public\n   */\n  didRequest(\n    request: ImmutableRequestInfo,\n    response: Response | ResponseInfo | null,\n    cacheKey: RequestKey | null,\n    store: Store\n  ): void {\n    // if this is a successful createRecord request, invalidate the cacheKey for the type\n    if (request.op === 'createRecord') {\n      const statusNumber = response?.status ?? 0;\n      if (statusNumber >= 200 && statusNumber < 400) {\n        const types = new Set(request.records?.map((r) => r.type));\n        const additionalTypes = request.cacheOptions?.types;\n        additionalTypes?.forEach((type) => {\n          types.add(type);\n        });\n\n        types.forEach((type) => {\n          this.invalidateRequestsForType(type, store);\n        });\n      }\n\n      // add this document's cacheKey to a map for all associated types\n      // it is recommended to only use this for queries\n    } else if (cacheKey && request.cacheOptions?.types?.length) {\n      const storeCache = this._getStore(store);\n      request.cacheOptions?.types.forEach((type) => {\n        const set = storeCache.types.get(type);\n        if (set) {\n          set.add(cacheKey);\n          storeCache.invalidated.delete(cacheKey);\n        } else {\n          storeCache.types.set(type, new Set([cacheKey]));\n        }\n      });\n    }\n  }\n\n  /**\n   * Invoked to determine if the request may be fulfilled from cache\n   * if possible.\n   *\n   * Note, this is only invoked by the {@link CacheHandler} if the request has\n   * a cache-key.\n   *\n   * If no cache entry is found or the entry is hard expired,\n   * the request will be fulfilled from the configured request handlers\n   * and the cache will be updated before returning the response.\n   *\n   * @public\n   * @return true if the request is considered hard expired\n   */\n  isHardExpired(cacheKey: RequestKey, store: Store): boolean {\n    // if we are explicitly invalidated, we are hard expired\n    const storeCache = this._getStore(store);\n    if (storeCache.invalidated.has(cacheKey)) {\n      return true;\n    }\n    const cache = store.cache;\n    const cached = cache.peekRequest(cacheKey);\n\n    if (!cached?.response) {\n      if (LOG_CACHE_POLICY) {\n        // oxlint-disable-next-line no-console\n        console.log(`CachePolicy: ${cacheKey.lid} is EXPIRED because no cache entry was found`);\n      }\n      return true;\n    }\n\n    return isExpired(cacheKey, cached, this.config);\n  }\n\n  /**\n   * Invoked if `isHardExpired` is false to determine if the request\n   * should be update behind the scenes if cache data is already available.\n   *\n   * Note, this is only invoked by the {@link CacheHandler} if the request has\n   * a cache-key.\n   *\n   * If true, the request will be fulfilled from cache while a backgrounded\n   * request is made to update the cache via the configured request handlers.\n   *\n   * @public\n   * @return true if the request is considered soft expired\n   */\n  isSoftExpired(cacheKey: RequestKey, store: Store): boolean {\n    if (TESTING) {\n      if (!this.config.disableTestOptimization) {\n        return false;\n      }\n    }\n    const cache = store.cache;\n    const cached = cache.peekRequest(cacheKey);\n\n    if (cached?.response) {\n      const date = cached.response.headers.get('date');\n\n      if (!date) {\n        if (LOG_CACHE_POLICY) {\n          // oxlint-disable-next-line no-console\n          console.log(`CachePolicy: ${cacheKey.lid} is STALE because no date header was found`);\n        }\n        return true;\n      } else {\n        const time = new Date(date).getTime();\n        const now = Date.now();\n        const deadline = time + this.config.apiCacheSoftExpires;\n        const result = now >= deadline;\n\n        if (LOG_CACHE_POLICY) {\n          // oxlint-disable-next-line no-console\n          console.log(\n            `CachePolicy: ${cacheKey.lid} is ${result ? 'STALE' : 'NOT stale'}. Expiration time: ${deadline}, now: ${now}`\n          );\n        }\n\n        return result;\n      }\n    }\n\n    if (LOG_CACHE_POLICY) {\n      // oxlint-disable-next-line no-console\n      console.log(`CachePolicy: ${cacheKey.lid} is STALE because no cache entry was found`);\n    }\n\n    return true;\n  }\n}\n"],"mappings":"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"}

package/dist/store.d.ts

@@ -1,2 +1,2 @@
-import { A as PolicyConfig, O as CacheControlValue, gn as NotificationManager, j as parseCacheControl, k as DefaultCachePolicy } from "./internal-BrqYbG_y.js";
+import { F as PolicyConfig, I as parseCacheControl, N as CacheControlValue, P as DefaultCachePolicy, rn as NotificationManager } from "./internal-D_WIXC4r.js";
 export { type CacheControlValue, DefaultCachePolicy, type NotificationManager, type PolicyConfig, parseCacheControl };

package/dist/store.js

@@ -1,3 +1,3 @@
-import { n as parseCacheControl, t as DefaultCachePolicy } from "./store-DNF9Rgoh.js";
+import { n as parseCacheControl, t as DefaultCachePolicy } from "./store-C8iKKtQK.js";
 
 export { DefaultCachePolicy, parseCacheControl };

package/dist/{symbols-DjRDCeX0.d.ts → symbols-DVa1PMFG.d.ts}

@@ -1,8 +1,8 @@
-//#region src/types/symbols.d.ts
 /**
  * Symbol used internally to stash a reference to the owning
  * {@link Store} on a record instance.
  *
+ * @summary Internal symbol key under which a record instance keeps a reference to the store that owns it.
  * @type {Symbol}
  */
 declare const RecordStore: "___(unique) Symbol(Store)";
@@ -42,6 +42,8 @@ declare const RecordStore: "___(unique) Symbol(Store)";
  * If used, `attr<Transform>('name')` will enforce
  * that the name is the same as the transform name.
  *
+ * @summary Symbol key that brands a record with its resource type for TypeScript, and names a derivation or
+ * transformation when it is registered.
  * @type {Symbol}
  */
 declare const Type: "___(unique) Symbol($type)";
@@ -56,6 +58,8 @@ declare const Type: "___(unique) Symbol($type)";
  * take advantage of this to provide better type
  * safety and intellisense.
  *
+ * @summary Alias of the `Type` symbol that a record type can declare to tell WarpDrive APIs its resource type for
+ * better type inference.
  * @type {Symbol}
  */
 declare const ResourceType: "___(unique) Symbol($type)";
@@ -73,6 +77,8 @@ declare const ResourceType: "___(unique) Symbol($type)";
  * If used, `attr<Transform>('name')` will enforce
  * that the name is the same as the transform name.
  *
+ * @summary Alias of the `Type` symbol that a legacy transform can declare so `attr<Transform>('name')` checks the
+ * transform name at the type level.
  * @type {Symbol}
  */
 declare const TransformName: "___(unique) Symbol($type)";
@@ -80,9 +86,10 @@ declare const TransformName: "___(unique) Symbol($type)";
  * Symbol for use by builders to indicate the return type
  * generic to use for store.request()
  *
+ * @summary Type-only symbol key that request builders set on the request they return so `store.request()` can
+ * infer the response type.
  * @type {Symbol}
  */
 declare const RequestSignature: "___(unique) Symbol(RequestSignature)";
-//#endregion
 export { Type as a, TransformName as i, RequestSignature as n, ResourceType as r, RecordStore as t };
-//# sourceMappingURL=symbols-DjRDCeX0.d.ts.map
+//# sourceMappingURL=symbols-DVa1PMFG.d.ts.map

package/dist/symbols-DVa1PMFG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols-DVa1PMFG.d.ts","names":[],"sources":["../src/types/symbols.ts"],"mappings":";;;;;;;cAiBa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0CA;;;;;;;;;;;;;;;;cAiBA;;;;;;;;;;;;;;;;;;;cAoBA;;;;;;;;;cAUA"}

package/dist/types/-private.d.ts

@@ -1,4 +1,3 @@
-//#region src/types/-private.d.ts
 type UniversalTransientKey = "REQ_ID";
 type UniversalKey = `(transient) ${UniversalTransientKey}` | "RequestMap" | "PromiseCache" | "RequestCache" | "SkipCache" | "EnableHydration" | "WarpDriveRuntimeConfig";
 type TransientKey = "transactionRef" | "configuredGenerationMethod" | "configuredUpdateMethod" | "configuredForgetMethod" | "configuredResetMethod" | "configuredKeyInfoMethod" | "signalHooks";
@@ -71,5 +70,5 @@ export declare function peekUniversalTransient<T>(key: UniversalTransientKey): T
  * @private
  */
 export declare function setUniversalTransient<T>(key: UniversalTransientKey, value: T): T;
-//#endregion
+export {};
 //# sourceMappingURL=-private.d.ts.map

package/dist/types/-private.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"-private.d.ts","names":[],"sources":["../../src/types/-private.ts"],"mappings":";KAMK;KAIA,8BACc;KAWd;KAWA,2BACc;KA8Gd,aAAa,0CAA0C;KACvD,eAAe,GAAG,oBAAoB,mBAAmB,aAAa,KAAK;;;;;;;;;;;;;;;;;;wBAmBhE,eAAe,GAAG,UAAU,WAAW,KAAK,GAAG,OAAO,IAAI,eAAe,GAAG;;;;;;;;;;;;wBAwB5E,cAAc,GAAG,KAAK,eAAe;;;;;;;;;wBAarC,aAAa,GAAG,KAAK,cAAc,OAAO,IAAI;;;;;;;;;;;wBAe9C,kBAAkB,GAAG,UAAU,cAAc,KAAK,GAAG,OAAO,IAAI,eAAe,GAAG;;;;;;;;wBAoBlF,uBAAuB,GAAG,KAAK,wBAAwB;;;;;;;;wBAYvD,sBAAsB,GAAG,KAAK,uBAAuB,OAAO,IAAI"}
+{"version":3,"file":"-private.d.ts","names":[],"sources":["../../src/types/-private.ts"],"mappings":"A,KAcK;KAIA,8BACc;KAWd;KAWA,2BACc;KA8Gd,aAAa,0CAA0C;KACvD,eAAe,GAAG,oBAAoB,mBAAmB,aAAa,KAAK;;;;;;;;;;;;;;;;;;wBAmBhE,eAAe,GAAG,UAAU,WAAW,KAAK,GAAG,OAAO,IAAI,eAAe,GAAG;;;;;;;;;;;;wBAwB5E,cAAc,GAAG,KAAK,eAAe;;;;;;;;;wBAarC,aAAa,GAAG,KAAK,cAAc,OAAO,IAAI;;;;;;;;;;;wBAe9C,kBAAkB,GAAG,UAAU,cAAc,KAAK,GAAG,OAAO,IAAI,eAAe,GAAG;;;;;;;;wBAoBlF,uBAAuB,GAAG,KAAK,wBAAwB;;;;;;;;wBAYvD,sBAAsB,GAAG,KAAK,uBAAuB,OAAO,IAAI"}

package/dist/types/-private.js

@@ -1,3 +1,116 @@
-import { a as setTransient, i as peekUniversalTransient, n as getOrSetUniversal, o as setUniversalTransient, r as peekTransient, t as getOrSetGlobal } from "../-private-CWh7qdp_.js";
+import { getGlobalConfig, macroCondition } from "@embroider/macros";
 
-export { getOrSetGlobal, getOrSetUniversal, peekTransient, peekUniversalTransient, setTransient, setUniversalTransient };
+// src/types/-private.ts
+const name = "@warp-drive-mirror/core";
+const version = "5.10.0-alpha.21";
+const GlobalRef = globalThis;
+const UniversalCache = GlobalRef.__warpDrive_universalCache = GlobalRef.__warpDrive_universalCache ?? {};
+GlobalRef[name] = GlobalRef[name] ?? { __version: version };
+const GlobalSink = GlobalRef[name];
+if (macroCondition(getGlobalConfig().WarpDriveMirror.env.DEBUG)) {
+	if (GlobalSink.__version !== version) throw new Error("Multiple versions of WarpDrive detected, the application will malfunction.");
+}
+const ModuleScopedCaches = GlobalSink.__warpDrive_ModuleScopedCaches ?? {};
+if (macroCondition(getGlobalConfig().WarpDriveMirror.env.TESTING)) {
+	if (!GlobalSink.__warpDrive_ModuleScopedCaches) GlobalSink.__warpDrive_ModuleScopedCaches = ModuleScopedCaches;
+	else console.warn(`
+Multiple copies of WarpDrive have been detected. This may be due to a bug in ember-auto-import
+  in which test assets get their own copy of some v2-addons. This can cause the application to
+  malfunction as each copy will maintain its own separate state.`);
+} else {
+	if (GlobalSink.__warpDrive_hasOtherCopy) throw new Error("Multiple copies of WarpDrive detected, the application will malfunction.");
+	GlobalSink.__warpDrive_hasOtherCopy = true;
+}
+/**
+* Coordinates creation of a singleton `value` (e.g. a symbol, WeakMap, or
+* error class) for `key` so that duplicate copies of this package loaded
+* into the same process observe the same instance instead of each creating
+* their own.
+*
+* In `TESTING` builds this stores/reads `value` from a cache namespaced to
+* this package's name on `globalThis` (see the file-level comments above for
+* why this is necessary). Outside of `TESTING`, only one copy of the package
+* is expected to exist, so this is a no-op that always returns `value`
+* unchanged.
+*
+* The return type lies about symbols being unique to work around the d.ts
+* rollup issue described in `reactive/-private/symbols.ts`.
+*
+* @private
+*/
+function getOrSetGlobal(key, value) {
+	if (macroCondition(getGlobalConfig().WarpDriveMirror.env.TESTING)) {
+		const existing = ModuleScopedCaches[key];
+		if (existing === void 0) return ModuleScopedCaches[key] = value;
+		else return existing;
+	} else return value;
+}
+/**
+* Reads back the current value stored for `key` by {@link setTransient}, or
+* `null` if nothing has been stored yet.
+*
+* Unlike {@link getOrSetGlobal}, this always reads through the same
+* package-namespaced cache regardless of the `TESTING` flag, since this is
+* used for genuinely mutable state (not just singleton values) that must
+* stay in sync across any duplicate copies of this package.
+*
+* @private
+*/
+function peekTransient(key) {
+	const globalKey = `(transient) ${key}`;
+	return ModuleScopedCaches[globalKey] ?? null;
+}
+/**
+* Stores `value` for `key`, overwriting whatever was previously stored, so
+* that it can later be read back via {@link peekTransient}.
+*
+* See {@link peekTransient} for details on when/why this cache is shared.
+*
+* @private
+*/
+function setTransient(key, value) {
+	const globalKey = `(transient) ${key}`;
+	return ModuleScopedCaches[globalKey] = value;
+}
+/**
+* Like {@link getOrSetGlobal}, but reads/writes a cache that is shared across
+* *all* copies of WarpDrive on `globalThis`, regardless of package name.
+*
+* This is used for keys (e.g. request/promise caches) that must be
+* coordinated even across "mirror" packages published under different
+* names, rather than only across duplicate copies of the same package name.
+*
+* @private
+*/
+function getOrSetUniversal(key, value) {
+	if (macroCondition(getGlobalConfig().WarpDriveMirror.env.TESTING)) {
+		const existing = UniversalCache[key];
+		if (existing === void 0) return UniversalCache[key] = value;
+		else return existing;
+	} else return value;
+}
+/**
+* Like {@link peekTransient}, but reads from the package-name-independent
+* cache used by {@link getOrSetUniversal}. Always reads through this shared
+* cache regardless of the `TESTING` flag.
+*
+* @private
+*/
+function peekUniversalTransient(key) {
+	const globalKey = `(transient) ${key}`;
+	return UniversalCache[globalKey] ?? null;
+}
+/**
+* Like {@link setTransient}, but writes to the package-name-independent
+* cache used by {@link getOrSetUniversal}, so it can later be read via
+* {@link peekUniversalTransient}.
+*
+* @private
+*/
+function setUniversalTransient(key, value) {
+	const globalKey = `(transient) ${key}`;
+	return UniversalCache[globalKey] = value;
+}
+
+export { getOrSetGlobal, getOrSetUniversal, peekTransient, peekUniversalTransient, setTransient, setUniversalTransient };
+//# sourceMappingURL=-private.js.map

package/dist/types/-private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"-private.js","names":["getGlobalConfig","macroCondition","name","__WARP_DRIVE_PACKAGE_NAME__","version","__WARP_DRIVE_PACKAGE_VERSION__","GlobalRef","globalThis","UniversalCache","__warpDrive_universalCache","__version","GlobalSink","WarpDrive","env","DEBUG","Error","ModuleScopedCaches","__warpDrive_ModuleScopedCaches","TESTING","console","warn","__warpDrive_hasOtherCopy","getOrSetGlobal","key","value","existing","undefined","peekTransient","globalKey","setTransient","getOrSetUniversal","peekUniversalTransient","setUniversalTransient"],"sources":["../../src/types/-private.ts"],"sourcesContent":["// in testing mode, we utilize globals to ensure only one copy exists of\n// these maps, due to bugs in ember-auto-import\nimport { DEBUG, TESTING } from '@warp-drive-mirror/core/build-config/env';\n\n// Substituted at build time (see `tools/internal-config/tsdown/config.js`)\n// with this package's own `name`/`version` from its `package.json`. Reading\n// it via a static import instead would get inlined by tsdown as a synthetic\n// sourcemap source with empty `sourcesContent`, which points outside the\n// published package once the built chunk is re-bundled by a consumer.\ndeclare const __WARP_DRIVE_PACKAGE_NAME__: string;\ndeclare const __WARP_DRIVE_PACKAGE_VERSION__: string;\nconst name = __WARP_DRIVE_PACKAGE_NAME__;\nconst version = __WARP_DRIVE_PACKAGE_VERSION__;\n\ntype UniversalTransientKey =\n  // @warp-drive-mirror/core/request\n  'REQ_ID';\n\ntype UniversalKey =\n  | `(transient) ${UniversalTransientKey}`\n  // @warp-drive-mirror/core/request\n  | 'RequestMap'\n  | 'PromiseCache'\n  | 'RequestCache'\n  // @warp-drive-mirror/core-types/request\n  | 'SkipCache'\n  | 'EnableHydration'\n  // @warp-drive-mirror/core-types/runtime\n  | 'WarpDriveRuntimeConfig';\n\ntype TransientKey =\n  // @warp-drive-mirror/core/graph\n  | 'transactionRef'\n  // @warp-drive-mirror/core/store\n  | 'configuredGenerationMethod'\n  | 'configuredUpdateMethod'\n  | 'configuredForgetMethod'\n  | 'configuredResetMethod'\n  | 'configuredKeyInfoMethod'\n  | 'signalHooks';\n\ntype GlobalKey =\n  | `(transient) ${TransientKey}`\n  // @warp-drive-mirror/legacy/adapter\n  | 'AdapterError'\n  | 'InvalidError'\n  | 'TimeoutError'\n  | 'AbortError'\n  | 'UnauthorizedError'\n  | 'ForbiddenError'\n  | 'NotFoundError'\n  | 'ConflictError'\n  | 'ServerError'\n  // @warp-drive-mirror/core/store/reactivity\n  | '#{}'\n  | '#[]'\n  | 'Signals'\n  // @warp-drive-mirror/legacy LegacySupport\n  | 'AvailableShims'\n  // @warp-drive-mirror/core RecordArrayManager\n  | 'FAKE_ARR'\n  // @warp-drive-mirror/core ReactiveArray\n  | '#source'\n  | '#update'\n  | '#notify'\n  | 'IS_COLLECTION'\n  // @warp-drive-mirror/core RequestCache\n  | 'Touching'\n  | 'RequestPromise'\n  // @warp-drive-mirror/legacy/compat FetchManager\n  | 'SaveOp'\n  // @warp-drive-mirror/legacy Model\n  | 'LEGACY_SUPPORT'\n  | 'LegacySupport'\n  // @warp-drive-mirror/core/graph\n  | 'Graphs'\n  // @warp-drive-mirror/core/request\n  | 'IS_FROZEN'\n  | 'IS_CACHE_HANDLER'\n  // @warp-drive-mirror/utilities\n  | 'CONFIG'\n  // @warp-drive-mirror/core CacheKeyManager\n  | 'DEBUG_MAP'\n  | 'IDENTIFIERS'\n  | 'DOCUMENTS'\n  // @warp-drive-mirror/core InstanceCache\n  | 'RecordCache'\n  | 'StoreMap'\n  // @warp-drive-mirror/core/types/symbols\n  | 'Store'\n  | '$type'\n  | 'TransformName'\n  | 'RequestSignature'\n  // @warp-drive-mirror/core/types/request\n  | 'IS_FUTURE'\n  | 'DOC'\n  // @warp-drive-mirror/core NotificationManager\n  | 'UnscopedChannel'\n  // @warp-drive-mirror/core/reactive\n  | 'ManagedArrayMap'\n  | 'ManagedObjectMap'\n  | 'Support'\n  | 'SOURCE'\n  | 'Destroy'\n  | 'Checkout'\n  | 'Commit'\n  | 'Context';\n\ntype ModuleScopedCaches = Record<GlobalKey, unknown>;\n\nconst GlobalRef = globalThis as unknown as Record<\n  string,\n  {\n    __warpDrive_ModuleScopedCaches?: ModuleScopedCaches;\n    __warpDrive_hasOtherCopy?: boolean;\n    __version: string;\n  }\n> & {\n  __warpDrive_universalCache: Record<UniversalKey, unknown>;\n};\nconst UniversalCache = (GlobalRef.__warpDrive_universalCache =\n  GlobalRef.__warpDrive_universalCache ?? ({} as Record<UniversalKey, unknown>));\n\n// in order to support mirror packages, we ensure that each\n// unique package name has its own global cache\nGlobalRef[name] = GlobalRef[name] ?? { __version: version };\nconst GlobalSink = GlobalRef[name];\n\nif (DEBUG) {\n  if (GlobalSink.__version !== version) {\n    throw new Error('Multiple versions of WarpDrive detected, the application will malfunction.');\n  }\n}\n\nconst ModuleScopedCaches = GlobalSink.__warpDrive_ModuleScopedCaches ?? ({} as ModuleScopedCaches);\nif (TESTING) {\n  if (!GlobalSink.__warpDrive_ModuleScopedCaches) {\n    GlobalSink.__warpDrive_ModuleScopedCaches = ModuleScopedCaches;\n  } else {\n    // oxlint-disable-next-line no-console\n    console.warn(`\nMultiple copies of WarpDrive have been detected. This may be due to a bug in ember-auto-import\n  in which test assets get their own copy of some v2-addons. This can cause the application to\n  malfunction as each copy will maintain its own separate state.`);\n  }\n} else {\n  if (GlobalSink.__warpDrive_hasOtherCopy) {\n    throw new Error('Multiple copies of WarpDrive detected, the application will malfunction.');\n  }\n  GlobalSink.__warpDrive_hasOtherCopy = true;\n}\n\ntype UniqueSymbol<T extends string> = `___(unique) Symbol(${T})`;\ntype UniqueSymbolOr<T, K extends string> = T extends symbol ? UniqueSymbol<K> : T;\n\n/**\n * Coordinates creation of a singleton `value` (e.g. a symbol, WeakMap, or\n * error class) for `key` so that duplicate copies of this package loaded\n * into the same process observe the same instance instead of each creating\n * their own.\n *\n * In `TESTING` builds this stores/reads `value` from a cache namespaced to\n * this package's name on `globalThis` (see the file-level comments above for\n * why this is necessary). Outside of `TESTING`, only one copy of the package\n * is expected to exist, so this is a no-op that always returns `value`\n * unchanged.\n *\n * The return type lies about symbols being unique to work around the d.ts\n * rollup issue described in `reactive/-private/symbols.ts`.\n *\n * @private\n */\nexport function getOrSetGlobal<T, K extends GlobalKey>(key: K, value: T): UniqueSymbolOr<T, K> {\n  if (TESTING) {\n    const existing = ModuleScopedCaches[key];\n    if (existing === undefined) {\n      return (ModuleScopedCaches[key] = value) as UniqueSymbolOr<T, K>;\n    } else {\n      return existing as UniqueSymbolOr<T, K>;\n    }\n  } else {\n    return value as UniqueSymbolOr<T, K>;\n  }\n}\n\n/**\n * Reads back the current value stored for `key` by {@link setTransient}, or\n * `null` if nothing has been stored yet.\n *\n * Unlike {@link getOrSetGlobal}, this always reads through the same\n * package-namespaced cache regardless of the `TESTING` flag, since this is\n * used for genuinely mutable state (not just singleton values) that must\n * stay in sync across any duplicate copies of this package.\n *\n * @private\n */\nexport function peekTransient<T>(key: TransientKey): T | null {\n  const globalKey: `(transient) ${TransientKey}` = `(transient) ${key}`;\n  return (ModuleScopedCaches[globalKey] as T) ?? null;\n}\n\n/**\n * Stores `value` for `key`, overwriting whatever was previously stored, so\n * that it can later be read back via {@link peekTransient}.\n *\n * See {@link peekTransient} for details on when/why this cache is shared.\n *\n * @private\n */\nexport function setTransient<T>(key: TransientKey, value: T): T {\n  const globalKey: `(transient) ${TransientKey}` = `(transient) ${key}`;\n  return (ModuleScopedCaches[globalKey] = value);\n}\n\n/**\n * Like {@link getOrSetGlobal}, but reads/writes a cache that is shared across\n * *all* copies of WarpDrive on `globalThis`, regardless of package name.\n *\n * This is used for keys (e.g. request/promise caches) that must be\n * coordinated even across \"mirror\" packages published under different\n * names, rather than only across duplicate copies of the same package name.\n *\n * @private\n */\nexport function getOrSetUniversal<T, K extends UniversalKey>(key: K, value: T): UniqueSymbolOr<T, K> {\n  if (TESTING) {\n    const existing = UniversalCache[key];\n    if (existing === undefined) {\n      return (UniversalCache[key] = value) as UniqueSymbolOr<T, K>;\n    } else {\n      return existing as UniqueSymbolOr<T, K>;\n    }\n  } else {\n    return value as UniqueSymbolOr<T, K>;\n  }\n}\n\n/**\n * Like {@link peekTransient}, but reads from the package-name-independent\n * cache used by {@link getOrSetUniversal}. Always reads through this shared\n * cache regardless of the `TESTING` flag.\n *\n * @private\n */\nexport function peekUniversalTransient<T>(key: UniversalTransientKey): T | null {\n  const globalKey: `(transient) ${UniversalTransientKey}` = `(transient) ${key}`;\n  return (UniversalCache[globalKey] as T) ?? null;\n}\n\n/**\n * Like {@link setTransient}, but writes to the package-name-independent\n * cache used by {@link getOrSetUniversal}, so it can later be read via\n * {@link peekUniversalTransient}.\n *\n * @private\n */\nexport function setUniversalTransient<T>(key: UniversalTransientKey, value: T): T {\n  const globalKey: `(transient) ${UniversalTransientKey}` = `(transient) ${key}`;\n  return (UniversalCache[globalKey] = value);\n}\n"],"mappings":";;;AAWA,MAAME;AACN,MAAME;AAkGN,MAAME,YAAYC;AAUlB,MAAMC,iBAAkBF,UAAUG,6BAChCH,UAAUG,8BAA+B,CAAC;AAI5CH,UAAUJ,QAAQI,UAAUJ,SAAS,EAAEQ,WAAWN,QAAQ;AAC1D,MAAMO,aAAaL,UAAUJ;AAE7B,IAAAD,eAAAD,gBAAA,CAAA,CAAAY,UAAAC,IAAAC,KAAA,GACE;KAAIH,WAAWD,cAAcN,SAC3B,MAAM,IAAIW,MAAM,4EAA4E;AAC9F;AAGF,MAAMC,qBAAqBL,WAAWM,kCAAmC,CAAC;AAC1E,IAAAhB,eAAAD,gBAAA,CAAA,CAAAY,UAAAC,IAAAK,OAAA,GAAa;CACX,IAAI,CAACP,WAAWM,gCACdN,WAAWM,iCAAiCD;MAG5CG,QAAQC,KAAK;;;iEAGgD;AAEjE,OAAO;CACL,IAAIT,WAAWU,0BACb,MAAM,IAAIN,MAAM,0EAA0E;CAE5FJ,WAAWU,2BAA2B;AACxC;;;;;;;;;;;;;;;;;;AAsBA,SAAgBC,eAAuCC,KAAQC,OAAgC;CAC7F,IAAAvB,eAAAD,gBAAA,CAAA,CAAAY,UAAAC,IAAAK,OAAA,GAAa;EACX,MAAMO,WAAWT,mBAAmBO;EACpC,IAAIE,aAAaC,QACf,OAAQV,mBAAmBO,OAAOC;OAElC,OAAOC;CAEX,OACE,OAAOD;AAEX;;;;;;;;;;;;AAaA,SAAgBG,cAAiBJ,KAA6B;CAC5D,MAAMK,YAA2C,eAAeL;CAChE,OAAQP,mBAAmBY,cAAoB;AACjD;;;;;;;;;AAUA,SAAgBC,aAAgBN,KAAmBC,OAAa;CAC9D,MAAMI,YAA2C,eAAeL;CAChE,OAAQP,mBAAmBY,aAAaJ;AAC1C;;;;;;;;;;;AAYA,SAAgBM,kBAA6CP,KAAQC,OAAgC;CACnG,IAAAvB,eAAAD,gBAAA,CAAA,CAAAY,UAAAC,IAAAK,OAAA,GAAa;EACX,MAAMO,WAAWjB,eAAee;EAChC,IAAIE,aAAaC,QACf,OAAQlB,eAAee,OAAOC;OAE9B,OAAOC;CAEX,OACE,OAAOD;AAEX;;;;;;;;AASA,SAAgBO,uBAA0BR,KAAsC;CAC9E,MAAMK,YAAoD,eAAeL;CACzE,OAAQf,eAAeoB,cAAoB;AAC7C;;;;;;;;AASA,SAAgBI,sBAAyBT,KAA4BC,OAAa;CAChF,MAAMI,YAAoD,eAAeL;CACzE,OAAQf,eAAeoB,aAAaJ;AACtC"}

package/dist/types/cache/aliases.d.ts

@@ -1,2 +1,2 @@
-import { t as ResourceBlob } from "../../aliases-BWYW5EhX.js";
+import { t as ResourceBlob } from "../../aliases-BG5TxALl.js";
 export { ResourceBlob };

package/dist/types/cache/change.d.ts

@@ -1,2 +1,2 @@
-import { t as Change } from "../../change-C7kqv2kW.js";
+import { t as Change } from "../../change-INHMiZ2a.js";
 export { Change };

package/dist/types/cache/mutations.d.ts

@@ -1,2 +1,2 @@
-import { a as ReplaceRelatedRecordsMutation, i as ReplaceRelatedRecordMutation, n as Mutation, o as SortRelatedRecordsMutation, r as RemoveFromResourceRelationshipMutation, t as AddToResourceRelationshipMutation } from "../../mutations-CqtoGB4t.js";
+import { a as ReplaceRelatedRecordsMutation, i as ReplaceRelatedRecordMutation, n as Mutation, o as SortRelatedRecordsMutation, r as RemoveFromResourceRelationshipMutation, t as AddToResourceRelationshipMutation } from "../../mutations-CA39mior.js";
 export { AddToResourceRelationshipMutation, Mutation, RemoveFromResourceRelationshipMutation, ReplaceRelatedRecordMutation, ReplaceRelatedRecordsMutation, SortRelatedRecordsMutation };

package/dist/types/cache/operations.d.ts

@@ -1,2 +1,2 @@
-import { a as Op, c as RemoveFromDocumentOperation, d as UpdateResourceFieldOperation, f as UpdateResourceOperation, i as MergeOperation, l as RemoveFromResourceRelationshipOperation, n as AddToDocumentOperation, o as Operation, p as UpdateResourceRelationshipOperation, r as AddToResourceRelationshipOperation, s as RemoveDocumentOperation, t as AddResourceOperation, u as RemoveResourceOperation } from "../../operations-D1qA6r0_.js";
+import { a as Op, c as RemoveFromDocumentOperation, d as UpdateResourceFieldOperation, f as UpdateResourceOperation, i as MergeOperation, l as RemoveFromResourceRelationshipOperation, n as AddToDocumentOperation, o as Operation, p as UpdateResourceRelationshipOperation, r as AddToResourceRelationshipOperation, s as RemoveDocumentOperation, t as AddResourceOperation, u as RemoveResourceOperation } from "../../operations-C1WAEKKq.js";
 export { AddResourceOperation, AddToDocumentOperation, AddToResourceRelationshipOperation, MergeOperation, Op, Operation, RemoveDocumentOperation, RemoveFromDocumentOperation, RemoveFromResourceRelationshipOperation, RemoveResourceOperation, UpdateResourceFieldOperation, UpdateResourceOperation, UpdateResourceRelationshipOperation };

package/dist/types/cache/relationship.d.ts

@@ -1,2 +1,2 @@
-import { n as Relationship, r as ResourceRelationship, t as CollectionRelationship } from "../../relationship-CmHzMPKf.js";
+import { n as Relationship, r as ResourceRelationship, t as CollectionRelationship } from "../../relationship-99pc4CaS.js";
 export { CollectionRelationship, Relationship, ResourceRelationship };

package/dist/types/cache.d.ts

@@ -1,2 +1,2 @@
-import { Gt as Cache, Kt as ChangedAttributesHash, qt as RelationshipDiff } from "../internal-BrqYbG_y.js";
+import { Qt as RelationshipDiff, Xt as Cache, Zt as ChangedAttributesHash } from "../internal-D_WIXC4r.js";
 export { Cache, ChangedAttributesHash, RelationshipDiff };

package/dist/types/graph.d.ts

@@ -1,2 +1,2 @@
-import { a as ReplaceRelatedRecordOperation, c as UnknownOperation, i as RemoteRelationshipOperation, l as UpdateRelationshipOperation, n as LocalRelationshipOperation, o as ReplaceRelatedRecordsOperation, r as Operation, s as SortRelatedRecords, t as DeleteRecordOperation } from "../graph-DLqYXP2z.js";
+import { a as ReplaceRelatedRecordOperation, c as UnknownOperation, i as RemoteRelationshipOperation, l as UpdateRelationshipOperation, n as LocalRelationshipOperation, o as ReplaceRelatedRecordsOperation, r as Operation, s as SortRelatedRecords, t as DeleteRecordOperation } from "../graph-BqxaFjEb.js";
 export { DeleteRecordOperation, LocalRelationshipOperation, Operation, RemoteRelationshipOperation, ReplaceRelatedRecordOperation, ReplaceRelatedRecordsOperation, SortRelatedRecords, UnknownOperation, UpdateRelationshipOperation };

package/dist/types/identifier.d.ts

@@ -1,2 +1,2 @@
-import { a as DEBUG_STALE_CACHE_OWNER, c as RequestKey, d as StableExistingRecordIdentifier, f as StableRecordIdentifier, i as DEBUG_KEY_TYPE, l as ResourceKey, n as CacheKeyType, o as NewResourceKey, r as DEBUG_CLIENT_ORIGINATED, s as PersistedResourceKey, t as CACHE_OWNER, u as StableDocumentIdentifier } from "../identifier-DQnqOSJK.js";
+import { a as DEBUG_STALE_CACHE_OWNER, c as RequestKey, d as StableExistingRecordIdentifier, f as StableRecordIdentifier, i as DEBUG_KEY_TYPE, l as ResourceKey, n as CacheKeyType, o as NewResourceKey, r as DEBUG_CLIENT_ORIGINATED, s as PersistedResourceKey, t as CACHE_OWNER, u as StableDocumentIdentifier } from "../identifier-DmgDehQK.js";
 export { CACHE_OWNER, CacheKeyType, DEBUG_CLIENT_ORIGINATED, DEBUG_KEY_TYPE, DEBUG_STALE_CACHE_OWNER, NewResourceKey, PersistedResourceKey, RequestKey, ResourceKey, StableDocumentIdentifier, StableExistingRecordIdentifier, StableRecordIdentifier };

package/dist/types/identifier.js

@@ -1,6 +1,11 @@
 import { getGlobalConfig, macroCondition } from "@embroider/macros";
 
-//#region src/types/identifier.ts
+// src/types/identifier.ts
+/**
+* @module
+* @summary Types for the stable keys that reference cached data, `ResourceKey` for resources and `RequestKey` for
+* request documents, plus their deprecated identifier aliases.
+*/
 /**
 * @private
 */
@@ -24,6 +29,8 @@ const CACHE_OWNER = ProdSymbol("__$co", "CACHE_OWNER");
 * Identifies which "bucket" of the cache a key belongs to: resources
 * (`'record'`, see {@link ResourceKey}) or request documents
 * (`'document'`, see {@link RequestKey}).
+*
+* @summary Which cache bucket a key belongs to: `'record'` for resource keys or `'document'` for request keys.
 */
 /**
 * A referentially stable object with a unique string (lid) that can be used
@@ -32,9 +39,17 @@ const CACHE_OWNER = ProdSymbol("__$co", "CACHE_OWNER");
 * Only requests that are assigned a RequestKey are retrievable/replayable from
 * the cache, though requests without RequestKeys may still update cache state.
 *
+* The [Key Terminology](/guides/the-manual/caching/key-terms#documents) guide explains
+* the documents it identifies.
+*
+* @summary Stable object with a unique `lid` that references a cached request document, letting that request's
+* result be retrieved or replayed.
 * @public
 */
-/** @deprecated use {@link RequestKey} */
+/**
+* @summary Deprecated alias for `RequestKey`, the stable cache reference to a request document.
+* @deprecated use {@link RequestKey}
+*/
 /**
 * Used when an ResourceKey is known to be the stable version
 */
@@ -45,8 +60,13 @@ const CACHE_OWNER = ProdSymbol("__$co", "CACHE_OWNER");
 * Distinguishing between this ResourceKey and one for a client created
 * resource that was created with an ID is generally speaking not possible
 * at runtime, so anything with an ID typically narrows to this.
+*
+* @summary Resource key whose `id` is a known string, the form keys for server-loaded resources take.
+*/
+/**
+* @summary Deprecated alias for `PersistedResourceKey`, a resource key whose `id` is known.
+* @deprecated use {@link PersistedResourceKey}
 */
-/** @deprecated use {@link PersistedResourceKey} */
 /**
 * Used when a ResourceKey was created locally
 * (by a call to store.createRecord).
@@ -55,6 +75,8 @@ const CACHE_OWNER = ProdSymbol("__$co", "CACHE_OWNER");
 * that is not for a new record but does not have an ID. This would
 * happen if a user intentionally created one for use with a secondary-index
 * prior to the record having been fully loaded.
+*
+* @summary Resource key for a record created locally with `store.createRecord`, whose `id` may still be `null`.
 */
 /**
 * A referentially stable object with a unique string (lid) that can be used
@@ -63,9 +85,16 @@ const CACHE_OWNER = ProdSymbol("__$co", "CACHE_OWNER");
 * Every resource has a unique ResourceKey, and ResourceKeys may refer
 * to data that has never been loaded (for instance, in an async relationship).
 *
+* The [Key Terminology](/guides/the-manual/caching/key-terms#resources) guide explains
+* the resources it identifies.
+*
+* @summary Stable object with a unique `lid` plus `type` and `id` that uniquely references one resource's data in
+* the cache, loaded or not.
 * @public
 */
-/** @deprecated use {@link ResourceKey} */
-//#endregion
+/**
+* @summary Deprecated alias for `ResourceKey`, the stable cache reference to a single resource.
+* @deprecated use {@link ResourceKey}
+*/
 export { CACHE_OWNER, DEBUG_CLIENT_ORIGINATED, DEBUG_KEY_TYPE, DEBUG_STALE_CACHE_OWNER };
 //# sourceMappingURL=identifier.js.map

package/dist/types/identifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"identifier.js","names":["getGlobalConfig","macroCondition","DEBUG_CLIENT_ORIGINATED","Symbol","DEBUG_KEY_TYPE","DEBUG_STALE_CACHE_OWNER","ProdSymbol","str","debugStr","WarpDrive","env","DEBUG","CACHE_OWNER"],"sources":["../../src/types/identifier.ts"],"sourcesContent":["import { DEBUG } from '@warp-drive-mirror/core/build-config/env';\n\n// provided for additional debuggability\n/**\n * @private\n */\nexport const DEBUG_CLIENT_ORIGINATED: unique symbol = Symbol('record-originated-on-client');\n/**\n * @private\n */\nexport const DEBUG_KEY_TYPE: unique symbol = Symbol('key-type');\n/**\n * @private\n */\nexport const DEBUG_STALE_CACHE_OWNER: unique symbol = Symbol('warpDriveStaleCache');\n\nfunction ProdSymbol<T extends string>(str: T, debugStr: string): T {\n  return DEBUG ? (Symbol(debugStr) as unknown as T) : str;\n}\n\n// also present in production\n/**\n * @private\n */\nexport const CACHE_OWNER: '__$co' = ProdSymbol('__$co', 'CACHE_OWNER');\n\n/**\n * Identifies which \"bucket\" of the cache a key belongs to: resources\n * (`'record'`, see {@link ResourceKey}) or request documents\n * (`'document'`, see {@link RequestKey}).\n */\nexport type CacheKeyType = 'record' | 'document';\n\n/**\n * A referentially stable object with a unique string (lid) that can be used\n * as a reference to request data in the cache.\n *\n * Only requests that are assigned a RequestKey are retrievable/replayable from\n * the cache, though requests without RequestKeys may still update cache state.\n *\n * @public\n */\nexport interface RequestKey {\n  /**\n   * A string representing a unique identity.\n   */\n  lid: string;\n  /**\n   * Discriminates a {@link RequestKey} from a {@link ResourceKey}.\n   */\n  type: '@document';\n  /** @internal */\n  [CACHE_OWNER]: number | undefined;\n}\n\n/** @deprecated use {@link RequestKey} */\nexport type StableDocumentIdentifier = RequestKey;\n\n/**\n * Used when an ResourceKey is known to be the stable version\n */\ninterface ResourceKeyBase<T extends string = string> {\n  /**\n   * A string representing a unique identity.\n   *\n   * @public\n   */\n  lid: string;\n\n  /**\n   * the primary `ResourceType` or \"model name\" this ResourceKey belongs to.\n   *\n   * @public\n   */\n  type: T;\n\n  /** @internal */\n  [CACHE_OWNER]: number | undefined;\n\n  /** @internal */\n  [DEBUG_CLIENT_ORIGINATED]?: boolean;\n  /** @internal */\n  [DEBUG_STALE_CACHE_OWNER]?: number | undefined;\n}\n\n/**\n * Used when a ResourceKey was not created locally as part\n * of a call to store.createRecord\n *\n * Distinguishing between this ResourceKey and one for a client created\n * resource that was created with an ID is generally speaking not possible\n * at runtime, so anything with an ID typically narrows to this.\n */\nexport interface PersistedResourceKey<T extends string = string> extends ResourceKeyBase<T> {\n  /**\n   * the PrimaryKey for the resource this ResourceKey represents.\n   *\n   * @public\n   */\n  id: string;\n}\n\n/** @deprecated use {@link PersistedResourceKey} */\nexport type StableExistingRecordIdentifier<T extends string = string> = PersistedResourceKey<T>;\n\n/**\n * Used when a ResourceKey was created locally\n * (by a call to store.createRecord).\n *\n * It is possible in rare circumstances to have a ResourceKey\n * that is not for a new record but does not have an ID. This would\n * happen if a user intentionally created one for use with a secondary-index\n * prior to the record having been fully loaded.\n */\nexport interface NewResourceKey<T extends string = string> extends ResourceKeyBase<T> {\n  /**\n   * the PrimaryKey for the resource this ResourceKey represents. `null`\n   * if not yet assigned a PrimaryKey value.\n   *\n   * @public\n   */\n  id: string | null;\n}\n\n/**\n * A referentially stable object with a unique string (lid) that can be used\n * as a reference to data in the cache.\n *\n * Every resource has a unique ResourceKey, and ResourceKeys may refer\n * to data that has never been loaded (for instance, in an async relationship).\n *\n * @public\n */\nexport type ResourceKey<T extends string = string> = PersistedResourceKey<T> | NewResourceKey<T>;\n\n/** @deprecated use {@link ResourceKey} */\nexport type StableRecordIdentifier<T extends string = string> = ResourceKey<T>;\n"],"mappings":";;;;;;AAMA,MAAaE,0BAAyCC,OAAO,6BAA6B;;;;AAI1F,MAAaC,iBAAgCD,OAAO,UAAU;;;;AAI9D,MAAaE,0BAAyCF,OAAO,qBAAqB;AAElF,SAASG,WAA6BC,KAAQC,UAAqB;CACjE,OAAOP,eAAAD,gBAAA,CAAA,CAAAS,UAAAC,IAAAC,KAAA,IAASR,OAAOK,QAAQ,IAAqBD;AACtD;;;;AAMA,MAAaK,cAAuBN,WAAW,SAAS,aAAa"}
+{"version":3,"file":"identifier.js","names":["getGlobalConfig","macroCondition","DEBUG_CLIENT_ORIGINATED","Symbol","DEBUG_KEY_TYPE","DEBUG_STALE_CACHE_OWNER","ProdSymbol","str","debugStr","WarpDrive","env","DEBUG","CACHE_OWNER"],"sources":["../../src/types/identifier.ts"],"sourcesContent":["/**\n * @module\n * @summary Types for the stable keys that reference cached data, `ResourceKey` for resources and `RequestKey` for\n * request documents, plus their deprecated identifier aliases.\n */\n\nimport { DEBUG } from '@warp-drive-mirror/core/build-config/env';\n\n// provided for additional debuggability\n/**\n * @private\n */\nexport const DEBUG_CLIENT_ORIGINATED: unique symbol = Symbol('record-originated-on-client');\n/**\n * @private\n */\nexport const DEBUG_KEY_TYPE: unique symbol = Symbol('key-type');\n/**\n * @private\n */\nexport const DEBUG_STALE_CACHE_OWNER: unique symbol = Symbol('warpDriveStaleCache');\n\nfunction ProdSymbol<T extends string>(str: T, debugStr: string): T {\n  return DEBUG ? (Symbol(debugStr) as unknown as T) : str;\n}\n\n// also present in production\n/**\n * @private\n */\nexport const CACHE_OWNER: '__$co' = ProdSymbol('__$co', 'CACHE_OWNER');\n\n/**\n * Identifies which \"bucket\" of the cache a key belongs to: resources\n * (`'record'`, see {@link ResourceKey}) or request documents\n * (`'document'`, see {@link RequestKey}).\n *\n * @summary Which cache bucket a key belongs to: `'record'` for resource keys or `'document'` for request keys.\n */\nexport type CacheKeyType = 'record' | 'document';\n\n/**\n * A referentially stable object with a unique string (lid) that can be used\n * as a reference to request data in the cache.\n *\n * Only requests that are assigned a RequestKey are retrievable/replayable from\n * the cache, though requests without RequestKeys may still update cache state.\n *\n * The [Key Terminology](/guides/the-manual/caching/key-terms#documents) guide explains\n * the documents it identifies.\n *\n * @summary Stable object with a unique `lid` that references a cached request document, letting that request's\n * result be retrieved or replayed.\n * @public\n */\nexport interface RequestKey {\n  /**\n   * A string representing a unique identity.\n   */\n  lid: string;\n  /**\n   * Discriminates a {@link RequestKey} from a {@link ResourceKey}.\n   */\n  type: '@document';\n  /** @internal */\n  [CACHE_OWNER]: number | undefined;\n}\n\n/**\n * @summary Deprecated alias for `RequestKey`, the stable cache reference to a request document.\n * @deprecated use {@link RequestKey}\n */\nexport type StableDocumentIdentifier = RequestKey;\n\n/**\n * Used when an ResourceKey is known to be the stable version\n */\ninterface ResourceKeyBase<T extends string = string> {\n  /**\n   * A string representing a unique identity.\n   *\n   * @public\n   */\n  lid: string;\n\n  /**\n   * the primary `ResourceType` or \"model name\" this ResourceKey belongs to.\n   *\n   * @public\n   */\n  type: T;\n\n  /** @internal */\n  [CACHE_OWNER]: number | undefined;\n\n  /** @internal */\n  [DEBUG_CLIENT_ORIGINATED]?: boolean;\n  /** @internal */\n  [DEBUG_STALE_CACHE_OWNER]?: number | undefined;\n}\n\n/**\n * Used when a ResourceKey was not created locally as part\n * of a call to store.createRecord\n *\n * Distinguishing between this ResourceKey and one for a client created\n * resource that was created with an ID is generally speaking not possible\n * at runtime, so anything with an ID typically narrows to this.\n *\n * @summary Resource key whose `id` is a known string, the form keys for server-loaded resources take.\n */\nexport interface PersistedResourceKey<T extends string = string> extends ResourceKeyBase<T> {\n  /**\n   * the PrimaryKey for the resource this ResourceKey represents.\n   *\n   * @public\n   */\n  id: string;\n}\n\n/**\n * @summary Deprecated alias for `PersistedResourceKey`, a resource key whose `id` is known.\n * @deprecated use {@link PersistedResourceKey}\n */\nexport type StableExistingRecordIdentifier<T extends string = string> = PersistedResourceKey<T>;\n\n/**\n * Used when a ResourceKey was created locally\n * (by a call to store.createRecord).\n *\n * It is possible in rare circumstances to have a ResourceKey\n * that is not for a new record but does not have an ID. This would\n * happen if a user intentionally created one for use with a secondary-index\n * prior to the record having been fully loaded.\n *\n * @summary Resource key for a record created locally with `store.createRecord`, whose `id` may still be `null`.\n */\nexport interface NewResourceKey<T extends string = string> extends ResourceKeyBase<T> {\n  /**\n   * the PrimaryKey for the resource this ResourceKey represents. `null`\n   * if not yet assigned a PrimaryKey value.\n   *\n   * @public\n   */\n  id: string | null;\n}\n\n/**\n * A referentially stable object with a unique string (lid) that can be used\n * as a reference to data in the cache.\n *\n * Every resource has a unique ResourceKey, and ResourceKeys may refer\n * to data that has never been loaded (for instance, in an async relationship).\n *\n * The [Key Terminology](/guides/the-manual/caching/key-terms#resources) guide explains\n * the resources it identifies.\n *\n * @summary Stable object with a unique `lid` plus `type` and `id` that uniquely references one resource's data in\n * the cache, loaded or not.\n * @public\n */\nexport type ResourceKey<T extends string = string> = PersistedResourceKey<T> | NewResourceKey<T>;\n\n/**\n * @summary Deprecated alias for `ResourceKey`, the stable cache reference to a single resource.\n * @deprecated use {@link ResourceKey}\n */\nexport type StableRecordIdentifier<T extends string = string> = ResourceKey<T>;\n"],"mappings":";;;;;;;;;;;AAYA,MAAaE,0BAAyCC,OAAO,6BAA6B;;;;AAI1F,MAAaC,iBAAgCD,OAAO,UAAU;;;;AAI9D,MAAaE,0BAAyCF,OAAO,qBAAqB;AAElF,SAASG,WAA6BC,KAAQC,UAAqB;CACjE,OAAOP,eAAAD,gBAAA,CAAA,CAAAS,UAAAC,IAAAC,KAAA,IAASR,OAAOK,QAAQ,IAAqBD;AACtD;;;;AAMA,MAAaK,cAAuBN,WAAW,SAAS,aAAa"}

package/dist/types/json/raw.d.ts

@@ -1,2 +1,2 @@
-import { i as Value, n as ObjectValue, r as PrimitiveValue, t as ArrayValue } from "../../raw-D5hnjiq7.js";
+import { i as Value, n as ObjectValue, r as PrimitiveValue, t as ArrayValue } from "../../raw-adYGuEGM.js";
 export { ArrayValue, ObjectValue, PrimitiveValue, Value };

package/dist/types/params.d.ts

@@ -1,2 +1,2 @@
-import { i as SerializablePrimitive, n as QueryParamsSource, r as Serializable, t as QueryParamsSerializationOptions } from "../params-DrEx3bf8.js";
+import { i as SerializablePrimitive, n as QueryParamsSource, r as Serializable, t as QueryParamsSerializationOptions } from "../params-CNLjCRyH.js";
 export { QueryParamsSerializationOptions, QueryParamsSource, Serializable, SerializablePrimitive };

package/dist/types/record.d.ts

@@ -1,2 +1,2 @@
-import { a as StringSatisfiesIncludes, c as TypedRecordInstance, i as OpaqueRecordInstance, l as Validate, n as Includes, o as TypeFromInstance, r as Mask, s as TypeFromInstanceOrString, t as ExtractSuggestedCacheTypes, u as createIncludeValidator } from "../record-D3QQcaIR.js";
+import { a as StringSatisfiesIncludes, c as TypedRecordInstance, i as OpaqueRecordInstance, l as Validate, n as Includes, o as TypeFromInstance, r as Mask, s as TypeFromInstanceOrString, t as ExtractSuggestedCacheTypes, u as createIncludeValidator } from "../record-f5-uOgHt.js";
 export { ExtractSuggestedCacheTypes, Includes, Mask, OpaqueRecordInstance, StringSatisfiesIncludes, TypeFromInstance, TypeFromInstanceOrString, TypedRecordInstance, Validate, createIncludeValidator };