@ember-data/request-utils 5.4.0-alpha.5 → 5.4.0-alpha.50

package/addon/index.js

@@ -1,4 +1,4 @@
-import { assert } from '@ember/debug';
+import { assert, deprecate } from '@ember/debug';
 
 /**
  * Simple utility function to assist in url building,
@@ -43,18 +43,70 @@ import { assert } from '@ember/debug';
 // prevents the final constructed object from needing to add
 // host and namespace which are provided by the final consuming
 // class to the prototype which can result in overwrite errors
-let CONFIG = {
+
+const CONFIG = {
   host: '',
   namespace: ''
 };
-function setBuildURLConfig(values) {
-  CONFIG = values;
+
+/**
+ * Sets the global configuration for `buildBaseURL`
+ * for host and namespace values for the application.
+ *
+ * These values may still be overridden by passing
+ * them to buildBaseURL directly.
+ *
+ * This method may be called as many times as needed.
+ * host values of `''` or `'/'` are equivalent.
+ *
+ * Except for the value of `/` as host, host should not
+ * end with `/`.
+ *
+ * namespace should not start or end with a `/`.
+ *
+ * ```ts
+ * type BuildURLConfig = {
+ *   host: string;
+ *   namespace: string'
+ * }
+ * ```
+ *
+ * Example:
+ *
+ * ```ts
+ * import { setBuildURLConfig } from '@ember-data/request-utils';
+ *
+ * setBuildURLConfig({
+ *   host: 'https://api.example.com',
+ *   namespace: 'api/v1'
+ * });
+ * ```
+ *
+ * @method setBuildURLConfig
+ * @static
+ * @public
+ * @for @ember-data/request-utils
+ * @param {BuildURLConfig} config
+ * @return void
+ */
+function setBuildURLConfig(config) {
+  assert(`setBuildURLConfig: You must pass a config object`, config);
+  assert(`setBuildURLConfig: You must pass a config object with a 'host' or 'namespace' property`, 'host' in config || 'namespace' in config);
+  CONFIG.host = config.host || '';
+  CONFIG.namespace = config.namespace || '';
+  assert(`buildBaseURL: host must NOT end with '/', received '${CONFIG.host}'`, CONFIG.host === '/' || !CONFIG.host.endsWith('/'));
+  assert(`buildBaseURL: namespace must NOT start with '/', received '${CONFIG.namespace}'`, !CONFIG.namespace.startsWith('/'));
+  assert(`buildBaseURL: namespace must NOT end with '/', received '${CONFIG.namespace}'`, !CONFIG.namespace.endsWith('/'));
 }
 const OPERATIONS_WITH_PRIMARY_RECORDS = new Set(['findRecord', 'findRelatedRecord', 'findRelatedCollection', 'updateRecord', 'deleteRecord']);
 function isOperationWithPrimaryRecord(options) {
-  return OPERATIONS_WITH_PRIMARY_RECORDS.has(options.op);
+  return 'op' in options && OPERATIONS_WITH_PRIMARY_RECORDS.has(options.op);
+}
+function hasResourcePath(options) {
+  return 'resourcePath' in options && typeof options.resourcePath === 'string' && options.resourcePath.length > 0;
 }
 function resourcePathForType(options) {
+  assert(`resourcePathForType: You must pass a valid op as part of options`, 'op' in options && typeof options.op === 'string');
   return options.op === 'findMany' ? options.identifiers[0].type : options.identifier.type;
 }
 
@@ -97,20 +149,20 @@ function resourcePathForType(options) {
  * @public
  * @for @ember-data/request-utils
  * @param urlOptions
- * @returns string
+ * @return string
  */
 function buildBaseURL(urlOptions) {
   const options = Object.assign({
     host: CONFIG.host,
     namespace: CONFIG.namespace
   }, urlOptions);
-  assert(`buildBaseURL: You must pass \`op\` as part of options`, typeof options.op === 'string' && options.op.length > 0);
-  assert(`buildBaseURL: You must pass \`identifier\` as part of options`, options.op === 'findMany' || options.identifier && typeof options.identifier === 'object');
-  assert(`buildBaseURL: You must pass \`identifiers\` as part of options`, options.op !== 'findMany' || options.identifiers && Array.isArray(options.identifiers) && options.identifiers.length > 0 && options.identifiers.every(i => i && typeof i === 'object'));
-  assert(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'id'`, !isOperationWithPrimaryRecord(options) || typeof options.identifier.id === 'string' && options.identifier.id.length > 0);
-  assert(`buildBaseURL: You must pass \`identifiers\` as part of options`, options.op !== 'findMany' || options.identifiers.every(i => typeof i.id === 'string' && i.id.length > 0));
-  assert(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'type'`, options.op === 'findMany' || typeof options.identifier.type === 'string' && options.identifier.type.length > 0);
-  assert(`buildBaseURL: You must pass valid \`identifiers\` as part of options, expected 'type'`, options.op !== 'findMany' || typeof options.identifiers[0].type === 'string' && options.identifiers[0].type.length > 0);
+  assert(`buildBaseURL: You must pass \`op\` as part of options`, hasResourcePath(options) || typeof options.op === 'string' && options.op.length > 0);
+  assert(`buildBaseURL: You must pass \`identifier\` as part of options`, hasResourcePath(options) || options.op === 'findMany' || options.identifier && typeof options.identifier === 'object');
+  assert(`buildBaseURL: You must pass \`identifiers\` as part of options`, hasResourcePath(options) || options.op !== 'findMany' || options.identifiers && Array.isArray(options.identifiers) && options.identifiers.length > 0 && options.identifiers.every(i => i && typeof i === 'object'));
+  assert(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'id'`, hasResourcePath(options) || !isOperationWithPrimaryRecord(options) || typeof options.identifier.id === 'string' && options.identifier.id.length > 0);
+  assert(`buildBaseURL: You must pass \`identifiers\` as part of options`, hasResourcePath(options) || options.op !== 'findMany' || options.identifiers.every(i => typeof i.id === 'string' && i.id.length > 0));
+  assert(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'type'`, hasResourcePath(options) || options.op === 'findMany' || typeof options.identifier.type === 'string' && options.identifier.type.length > 0);
+  assert(`buildBaseURL: You must pass valid \`identifiers\` as part of options, expected 'type'`, hasResourcePath(options) || options.op !== 'findMany' || typeof options.identifiers[0].type === 'string' && options.identifiers[0].type.length > 0);
 
   // prettier-ignore
   const idPath = isOperationWithPrimaryRecord(options) ? encodeURIComponent(options.identifier.id) : '';
@@ -120,7 +172,7 @@ function buildBaseURL(urlOptions) {
     namespace
   } = options;
   const fieldPath = 'fieldPath' in options ? options.fieldPath : '';
-  assert(`buildBaseURL: You tried to build a ${String(options.op)} request to ${resourcePath} but op must be one of "${['findRecord', 'findRelatedRecord', 'findRelatedCollection', 'updateRecord', 'deleteRecord', 'createRecord', 'query', 'findMany'].join('","')}".`, ['findRecord', 'query', 'findMany', 'findRelatedCollection', 'findRelatedRecord', 'createRecord', 'updateRecord', 'deleteRecord'].includes(options.op));
+  assert(`buildBaseURL: You tried to build a url for a ${String('op' in options ? options.op + ' ' : '')}request to ${resourcePath} but resourcePath must be set or op must be one of "${['findRecord', 'findRelatedRecord', 'findRelatedCollection', 'updateRecord', 'deleteRecord', 'createRecord', 'query', 'findMany'].join('","')}".`, hasResourcePath(options) || ['findRecord', 'query', 'findMany', 'findRelatedCollection', 'findRelatedRecord', 'createRecord', 'updateRecord', 'deleteRecord'].includes(options.op));
   assert(`buildBaseURL: host must NOT end with '/', received '${host}'`, host === '/' || !host.endsWith('/'));
   assert(`buildBaseURL: namespace must NOT start with '/', received '${namespace}'`, !namespace.startsWith('/'));
   assert(`buildBaseURL: namespace must NOT end with '/', received '${namespace}'`, !namespace.endsWith('/'));
@@ -130,8 +182,9 @@ function buildBaseURL(urlOptions) {
   assert(`buildBaseURL: fieldPath must NOT end with '/', received '${fieldPath}'`, !fieldPath.endsWith('/'));
   assert(`buildBaseURL: idPath must NOT start with '/', received '${idPath}'`, !idPath.startsWith('/'));
   assert(`buildBaseURL: idPath must NOT end with '/', received '${idPath}'`, !idPath.endsWith('/'));
-  const url = [host === '/' ? '' : host, namespace, resourcePath, idPath, fieldPath].filter(Boolean).join('/');
-  return host ? url : `/${url}`;
+  const hasHost = host !== '' && host !== '/';
+  const url = [hasHost ? host : '', namespace, resourcePath, idPath, fieldPath].filter(Boolean).join('/');
+  return hasHost ? url : `/${url}`;
 }
 const DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS = {
   arrayFormat: 'comma'
@@ -140,20 +193,56 @@ function handleInclude(include) {
   assert(`Expected include to be a string or array, got ${typeof include}`, typeof include === 'string' || Array.isArray(include));
   return typeof include === 'string' ? include.split(',') : include;
 }
-function filterEmpty(obj) {
+
+/**
+ * filter out keys of an object that have falsy values or point to empty arrays
+ * returning a new object with only those keys that have truthy values / non-empty arrays
+ *
+ * @method filterEmpty
+ * @static
+ * @public
+ * @for @ember-data/request-utils
+ * @param {Record<string, Serializable>} source object to filter keys with empty values from
+ * @return {Record<string, Serializable>} A new object with the keys that contained empty values removed
+ */
+function filterEmpty(source) {
   const result = {};
-  for (const key in obj) {
-    const value = obj[key];
-    if (value) {
+  for (const key in source) {
+    const value = source[key];
+    // Allow `0` and `false` but filter falsy values that indicate "empty"
+    if (value !== undefined && value !== null && value !== '') {
       if (!Array.isArray(value) || value.length > 0) {
-        result[key] = obj[key];
+        result[key] = source[key];
       }
     }
   }
   return result;
 }
+
+/**
+ * Sorts query params by both key and value returning a new URLSearchParams
+ * object with the keys inserted in sorted order.
+ *
+ * Treats `included` specially, splicing it into an array if it is a string and sorting the array.
+ *
+ * Options:
+ * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
+ *
+ * 'bracket': appends [] to the key for every value e.g. `&ids[]=1&ids[]=2`
+ * 'indices': appends [i] to the key for every value e.g. `&ids[0]=1&ids[1]=2`
+ * 'repeat': appends the key for every value e.g. `&ids=1&ids=2`
+ * 'comma' (default): appends the key once with a comma separated list of values e.g. `&ids=1,2`
+ *
+ * @method sortQueryParams
+ * @static
+ * @public
+ * @for @ember-data/request-utils
+ * @param {URLSearchParams | object} params
+ * @param {object} options
+ * @return {URLSearchParams} A URLSearchParams with keys inserted in sorted order
+ */
 function sortQueryParams(params, options) {
-  options = Object.assign({}, DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS, options);
+  const opts = Object.assign({}, DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS, options);
   const paramsIsObject = !(params instanceof URLSearchParams);
   const urlParams = new URLSearchParams();
   const dictionaryParams = paramsIsObject ? params : {};
@@ -180,7 +269,7 @@ function sortQueryParams(params, options) {
     const value = dictionaryParams[key];
     if (Array.isArray(value)) {
       value.sort();
-      switch (options.arrayFormat) {
+      switch (opts.arrayFormat) {
         case 'indices':
           value.forEach((v, i) => {
             urlParams.append(`${key}[${i}]`, String(v));
@@ -207,22 +296,79 @@ function sortQueryParams(params, options) {
   });
   return urlParams;
 }
+
+/**
+ * Sorts query params by both key and value, returning a query params string
+ *
+ * Treats `included` specially, splicing it into an array if it is a string and sorting the array.
+ *
+ * Options:
+ * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
+ *
+ * 'bracket': appends [] to the key for every value e.g. `ids[]=1&ids[]=2`
+ * 'indices': appends [i] to the key for every value e.g. `ids[0]=1&ids[1]=2`
+ * 'repeat': appends the key for every value e.g. `ids=1&ids=2`
+ * 'comma' (default): appends the key once with a comma separated list of values e.g. `ids=1,2`
+ *
+ * @method buildQueryParams
+ * @static
+ * @public
+ * @for @ember-data/request-utils
+ * @param {URLSearchParams | object} params
+ * @param {object} [options]
+ * @return {string} A sorted query params string without the leading `?`
+ */
 function buildQueryParams(params, options) {
   return sortQueryParams(params, options).toString();
 }
 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;
+ * }
+ * ```
+ * @method parseCacheControl
+ * @static
+ * @public
+ * @for @ember-data/request-utils
+ * @param {string} header
+ * @return {CacheControlValue}
+ */
 function parseCacheControl(header) {
   let key = '';
   let value = '';
   let isParsingKey = true;
-  let cacheControlValue = {};
+  const cacheControlValue = {};
+  function parseCacheControlValue(stringToParse) {
+    const parsedValue = Number.parseInt(stringToParse);
+    assert(`Invalid Cache-Control value, expected a number but got - ${stringToParse}`, !Number.isNaN(parsedValue));
+    return parsedValue;
+  }
   for (let i = 0; i < header.length; i++) {
-    let char = header.charAt(i);
+    const char = header.charAt(i);
     if (char === ',') {
       assert(`Invalid Cache-Control value, expected a value`, !isParsingKey || !NUMERIC_KEYS.has(key));
       assert(`Invalid Cache-Control value, expected a value after "=" but got ","`, i === 0 || header.charAt(i - 1) !== '=');
       isParsingKey = true;
-      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? Number.parseInt(value) : 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;
@@ -237,7 +383,8 @@ function parseCacheControl(header) {
       value += char;
     }
     if (i === header.length - 1) {
-      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? Number.parseInt(value) : 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;
     }
   }
   return cacheControlValue;
@@ -257,17 +404,231 @@ function isStale(headers, expirationTime) {
   const result = now > deadline;
   return result;
 }
+/**
+ * A basic LifetimesService 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.
+ *
+ * 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 identifiers
+ * 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 `@ember-data/request/fetch` 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 { LifetimesService } from '@ember-data/request-utils';
+ * import DataStore from '@ember-data/store';
+ *
+ * // ...
+ *
+ * export class Store extends DataStore {
+ *   constructor(args) {
+ *     super(args);
+ *     this.lifetimes = new LifetimesService({ apiCacheSoftExpires: 30_000, apiCacheHardExpires: 60_000 });
+ *   }
+ * }
+ * ```
+ *
+ * @class LifetimesService
+ * @public
+ * @module @ember-data/request-utils
+ */
 class LifetimesService {
-  constructor(store, config) {
-    this.store = store;
-    this.config = config;
+  _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 LifetimesService 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: '5.4'
+      },
+      for: '@ember-data/request-utils',
+      until: '6.0'
+    });
+    assert(`You must pass a config to the LifetimesService`, _config);
+    assert(`You must pass a apiCacheSoftExpires to the LifetimesService`, typeof _config.apiCacheSoftExpires === 'number');
+    assert(`You must pass a apiCacheHardExpires to the LifetimesService`, typeof _config.apiCacheHardExpires === 'number');
+    this.config = _config;
+  }
+
+  /**
+   * Invalidate a request by its identifier for a given store instance.
+   *
+   * While the store argument may seem redundant, the lifetimes service
+   * is designed to be shared across multiple stores / forks
+   * of the store.
+   *
+   * ```ts
+   * store.lifetimes.invalidateRequest(store, identifier);
+   * ```
+   *
+   * @method invalidateRequest
+   * @public
+   * @param {StableDocumentIdentifier} identifier
+   * @param {Store} store
+   */
+  invalidateRequest(identifier, store) {
+    this._getStore(store).invalidated.add(identifier.lid);
+  }
+
+  /**
+   * Invalidate all requests associated to a specific type
+   * for a given store instance.
+   *
+   * While the store argument may seem redundant, the lifetimes service
+   * 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');
+   * ```
+   *
+   * @method invalidateRequestsForType
+   * @public
+   * @param {string} type
+   * @param {Store} store
+   */
+  invalidateRequestsForType(type, store) {
+    const storeCache = this._getStore(store);
+    const set = storeCache.types.get(type);
+    if (set) {
+      set.forEach(id => {
+        storeCache.invalidated.add(id);
+      });
+    }
+  }
+
+  /**
+   * 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.
+   *
+   * @method didRequest
+   * @public
+   * @param {ImmutableRequestInfo} request
+   * @param {ImmutableResponse} response
+   * @param {Store} store
+   * @param {StableDocumentIdentifier | null} identifier
+   * @return {void}
+   */
+  didRequest(request, response, identifier, 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 (identifier && request.cacheOptions?.types?.length) {
+      const storeCache = this._getStore(store);
+      request.cacheOptions?.types.forEach(type => {
+        const set = storeCache.types.get(type);
+        if (set) {
+          set.add(identifier.lid);
+          storeCache.invalidated.delete(identifier.lid);
+        } else {
+          storeCache.types.set(type, new Set([identifier.lid]));
+        }
+      });
+    }
   }
-  isHardExpired(identifier) {
-    const cached = this.store.cache.peekRequest(identifier);
+
+  /**
+   * 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.
+   *
+   * @method isHardExpired
+   * @public
+   * @param {StableDocumentIdentifier} identifier
+   * @param {Store} store
+   * @return {boolean} true if the request is considered hard expired
+   */
+  isHardExpired(identifier, store) {
+    // if we are explicitly invalidated, we are hard expired
+    const storeCache = this._getStore(store);
+    if (storeCache.invalidated.has(identifier.lid)) {
+      return true;
+    }
+    const cache = store.cache;
+    const cached = cache.peekRequest(identifier);
     return !cached || !cached.response || isStale(cached.response.headers, this.config.apiCacheHardExpires);
   }
-  isSoftExpired(identifier) {
-    const cached = this.store.cache.peekRequest(identifier);
+
+  /**
+   * 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.
+   *
+   * @method isSoftExpired
+   * @public
+   * @param {StableDocumentIdentifier} identifier
+   * @param {Store} store
+   * @return {boolean} true if the request is considered soft expired
+   */
+  isSoftExpired(identifier, store) {
+    const cache = store.cache;
+    const cached = cache.peekRequest(identifier);
     return !cached || !cached.response || isStale(cached.response.headers, this.config.apiCacheSoftExpires);
   }
 }

package/addon/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import { assert } from '@ember/debug';\n\nimport type Store from '@ember-data/store';\nimport { StableDocumentIdentifier } from '@ember-data/types/cache/identifier';\n\n/**\n * Simple utility function to assist in url building,\n * query params, and other common request operations.\n *\n * These primitives may be used directly or composed\n * by request builders to provide a consistent interface\n * for building requests.\n *\n * For instance:\n *\n * ```ts\n * import { buildBaseURL, buildQueryParams } from '@ember-data/request-utils';\n *\n * const baseURL = buildBaseURL({\n *   host: 'https://api.example.com',\n *   namespace: 'api/v1',\n *   resourcePath: 'emberDevelopers',\n *   op: 'query',\n *   identifier: { type: 'ember-developer' }\n * });\n * const url = `${baseURL}?${buildQueryParams({ name: 'Chris', include:['pets'] })}`;\n * // => 'https://api.example.com/api/v1/emberDevelopers?include=pets&name=Chris'\n * ```\n *\n * This is useful, but not as useful as the REST request builder for query which is sugar\n * over this (and more!):\n *\n * ```ts\n * import { query } from '@ember-data/rest/request';\n *\n * const options = query('ember-developer', { name: 'Chris', include:['pets'] });\n * // => { url: 'https://api.example.com/api/v1/emberDevelopers?include=pets&name=Chris' }\n * // Note: options will also include other request options like headers, method, etc.\n * ```\n *\n * @module @ember-data/request-utils\n * @main @ember-data/request-utils\n * @public\n */\n\n// prevents the final constructed object from needing to add\n// host and namespace which are provided by the final consuming\n// class to the prototype which can result in overwrite errors\n\ninterface BuildURLConfig {\n  host: string | null;\n  namespace: string | null;\n}\n\nlet CONFIG: BuildURLConfig = {\n  host: '',\n  namespace: '',\n};\n\nexport function setBuildURLConfig(values: BuildURLConfig) {\n  CONFIG = values;\n}\n\nexport interface FindRecordUrlOptions {\n  op: 'findRecord';\n  identifier: { type: string; id: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface QueryUrlOptions {\n  op: 'query';\n  identifier: { type: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface FindManyUrlOptions {\n  op: 'findMany';\n  identifiers: { type: string; id: string }[];\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\nexport interface FindRelatedCollectionUrlOptions {\n  op: 'findRelatedCollection';\n  identifier: { type: string; id: string };\n  fieldPath: string;\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface FindRelatedResourceUrlOptions {\n  op: 'findRelatedRecord';\n  identifier: { type: string; id: string };\n  fieldPath: string;\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface CreateRecordUrlOptions {\n  op: 'createRecord';\n  identifier: { type: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface UpdateRecordUrlOptions {\n  op: 'updateRecord';\n  identifier: { type: string; id: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface DeleteRecordUrlOptions {\n  op: 'deleteRecord';\n  identifier: { type: string; id: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport type UrlOptions =\n  | FindRecordUrlOptions\n  | QueryUrlOptions\n  | FindManyUrlOptions\n  | FindRelatedCollectionUrlOptions\n  | FindRelatedResourceUrlOptions\n  | CreateRecordUrlOptions\n  | UpdateRecordUrlOptions\n  | DeleteRecordUrlOptions;\n\nconst OPERATIONS_WITH_PRIMARY_RECORDS = new Set([\n  'findRecord',\n  'findRelatedRecord',\n  'findRelatedCollection',\n  'updateRecord',\n  'deleteRecord',\n]);\n\nfunction isOperationWithPrimaryRecord(\n  options: UrlOptions\n): options is\n  | FindRecordUrlOptions\n  | FindRelatedCollectionUrlOptions\n  | FindRelatedResourceUrlOptions\n  | UpdateRecordUrlOptions\n  | DeleteRecordUrlOptions {\n  return OPERATIONS_WITH_PRIMARY_RECORDS.has(options.op);\n}\n\nfunction resourcePathForType(options: UrlOptions): string {\n  return options.op === 'findMany' ? options.identifiers[0].type : options.identifier.type;\n}\n\n/**\n * Builds a URL for a request based on the provided options.\n * Does not include support for building query params (see `buildQueryParams`)\n * so that it may be composed cleanly with other query-params strategies.\n *\n * Usage:\n *\n * ```ts\n * import { buildBaseURL } from '@ember-data/request-utils';\n *\n * const url = buildBaseURL({\n *   host: 'https://api.example.com',\n *   namespace: 'api/v1',\n *   resourcePath: 'emberDevelopers',\n *   op: 'query',\n *   identifier: { type: 'ember-developer' }\n * });\n *\n * // => 'https://api.example.com/api/v1/emberDevelopers'\n * ```\n *\n * On the surface this may seem like a lot of work to do something simple, but\n * it is designed to be composable with other utilities and interfaces that the\n * average product engineer will never need to see or use.\n *\n * A few notes:\n *\n * - `resourcePath` is optional, but if it is not provided, `identifier.type` will be used.\n * - `host` and `namespace` are optional, but if they are not provided, the values globally\n *    configured via `setBuildURLConfig` will be used.\n * - `op` is required and must be one of the following:\n *   - 'findRecord' 'query' 'findMany' 'findRelatedCollection' 'findRelatedRecord'` 'createRecord' 'updateRecord' 'deleteRecord'\n * - Depending on the value of `op`, `identifier` or `identifiers` will be required.\n *\n * @method buildBaseURL\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param urlOptions\n * @returns string\n */\nexport function buildBaseURL(urlOptions: UrlOptions): string {\n  const options = Object.assign(\n    {\n      host: CONFIG.host,\n      namespace: CONFIG.namespace,\n    },\n    urlOptions\n  );\n  assert(\n    `buildBaseURL: You must pass \\`op\\` as part of options`,\n    typeof options.op === 'string' && options.op.length > 0\n  );\n  assert(\n    `buildBaseURL: You must pass \\`identifier\\` as part of options`,\n    options.op === 'findMany' || (options.identifier && typeof options.identifier === 'object')\n  );\n  assert(\n    `buildBaseURL: You must pass \\`identifiers\\` as part of options`,\n    options.op !== 'findMany' ||\n      (options.identifiers &&\n        Array.isArray(options.identifiers) &&\n        options.identifiers.length > 0 &&\n        options.identifiers.every((i) => i && typeof i === 'object'))\n  );\n  assert(\n    `buildBaseURL: You must pass valid \\`identifier\\` as part of options, expected 'id'`,\n    !isOperationWithPrimaryRecord(options) ||\n      (typeof options.identifier.id === 'string' && options.identifier.id.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass \\`identifiers\\` as part of options`,\n    options.op !== 'findMany' || options.identifiers.every((i) => typeof i.id === 'string' && i.id.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass valid \\`identifier\\` as part of options, expected 'type'`,\n    options.op === 'findMany' || (typeof options.identifier.type === 'string' && options.identifier.type.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass valid \\`identifiers\\` as part of options, expected 'type'`,\n    options.op !== 'findMany' ||\n      (typeof options.identifiers[0].type === 'string' && options.identifiers[0].type.length > 0)\n  );\n\n  // prettier-ignore\n  const idPath: string =\n      isOperationWithPrimaryRecord(options) ? encodeURIComponent(options.identifier.id)\n      : '';\n  const resourcePath = options.resourcePath || resourcePathForType(options);\n  const { host, namespace } = options;\n  const fieldPath = 'fieldPath' in options ? options.fieldPath : '';\n\n  assert(\n    `buildBaseURL: You tried to build a ${String(\n      (options as { op: string }).op\n    )} request to ${resourcePath} but op must be one of \"${[\n      'findRecord',\n      'findRelatedRecord',\n      'findRelatedCollection',\n      'updateRecord',\n      'deleteRecord',\n      'createRecord',\n      'query',\n      'findMany',\n    ].join('\",\"')}\".`,\n    [\n      'findRecord',\n      'query',\n      'findMany',\n      'findRelatedCollection',\n      'findRelatedRecord',\n      'createRecord',\n      'updateRecord',\n      'deleteRecord',\n    ].includes(options.op)\n  );\n\n  assert(`buildBaseURL: host must NOT end with '/', received '${host}'`, host === '/' || !host.endsWith('/'));\n  assert(`buildBaseURL: namespace must NOT start with '/', received '${namespace}'`, !namespace.startsWith('/'));\n  assert(`buildBaseURL: namespace must NOT end with '/', received '${namespace}'`, !namespace.endsWith('/'));\n  assert(\n    `buildBaseURL: resourcePath must NOT start with '/', received '${resourcePath}'`,\n    !resourcePath.startsWith('/')\n  );\n  assert(`buildBaseURL: resourcePath must NOT end with '/', received '${resourcePath}'`, !resourcePath.endsWith('/'));\n  assert(`buildBaseURL: fieldPath must NOT start with '/', received '${fieldPath}'`, !fieldPath.startsWith('/'));\n  assert(`buildBaseURL: fieldPath must NOT end with '/', received '${fieldPath}'`, !fieldPath.endsWith('/'));\n  assert(`buildBaseURL: idPath must NOT start with '/', received '${idPath}'`, !idPath.startsWith('/'));\n  assert(`buildBaseURL: idPath must NOT end with '/', received '${idPath}'`, !idPath.endsWith('/'));\n\n  const url = [host === '/' ? '' : host, namespace, resourcePath, idPath, fieldPath].filter(Boolean).join('/');\n  return host ? url : `/${url}`;\n}\n\ntype SerializablePrimitive = string | number | boolean | null;\ntype Serializable = SerializablePrimitive | SerializablePrimitive[];\nexport type QueryParamsSerializationOptions = {\n  arrayFormat?: 'bracket' | 'indices' | 'repeat' | 'comma';\n};\nexport type QueryParamsSource = Record<string, Serializable> | URLSearchParams;\n\nconst DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS: QueryParamsSerializationOptions = {\n  arrayFormat: 'comma',\n};\n\nfunction handleInclude(include: string | string[]): string[] {\n  assert(\n    `Expected include to be a string or array, got ${typeof include}`,\n    typeof include === 'string' || Array.isArray(include)\n  );\n  return typeof include === 'string' ? include.split(',') : include;\n}\n\nexport function filterEmpty(obj: Record<string, Serializable>): Record<string, Serializable> {\n  const result: Record<string, Serializable> = {};\n  for (const key in obj) {\n    const value = obj[key];\n    if (value) {\n      if (!Array.isArray(value) || value.length > 0) {\n        result[key] = obj[key];\n      }\n    }\n  }\n  return result;\n}\n\nexport function sortQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): URLSearchParams {\n  options = Object.assign({}, DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS, options);\n  const paramsIsObject = !(params instanceof URLSearchParams);\n  const urlParams = new URLSearchParams();\n  const dictionaryParams: Record<string, Serializable> = paramsIsObject ? params : {};\n\n  if (!paramsIsObject) {\n    params.forEach((value, key) => {\n      const hasExisting = key in dictionaryParams;\n      if (!hasExisting) {\n        dictionaryParams[key] = value;\n      } else {\n        const existingValue = dictionaryParams[key];\n        if (Array.isArray(existingValue)) {\n          existingValue.push(value);\n        } else {\n          dictionaryParams[key] = [existingValue, value];\n        }\n      }\n    });\n  }\n\n  if ('include' in dictionaryParams) {\n    dictionaryParams.include = handleInclude(dictionaryParams.include as string | string[]);\n  }\n\n  const sortedKeys = Object.keys(dictionaryParams).sort();\n  sortedKeys.forEach((key) => {\n    const value = dictionaryParams[key];\n    if (Array.isArray(value)) {\n      value.sort();\n      switch (options!.arrayFormat) {\n        case 'indices':\n          value.forEach((v, i) => {\n            urlParams.append(`${key}[${i}]`, String(v));\n          });\n          return;\n        case 'bracket':\n          value.forEach((v) => {\n            urlParams.append(`${key}[]`, String(v));\n          });\n          return;\n        case 'repeat':\n          value.forEach((v) => {\n            urlParams.append(key, String(v));\n          });\n          return;\n        case 'comma':\n        default:\n          urlParams.append(key, value.join(','));\n          return;\n      }\n    } else {\n      urlParams.append(key, String(value));\n    }\n  });\n\n  return urlParams;\n}\n\nexport function buildQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): string {\n  return sortQueryParams(params, options).toString();\n}\nexport 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\nconst NUMERIC_KEYS = new Set(['max-age', 's-maxage', 'stale-if-error', 'stale-while-revalidate']);\n\nexport function parseCacheControl(header: string): CacheControlValue {\n  let key = '';\n  let value = '';\n  let isParsingKey = true;\n  let cacheControlValue: CacheControlValue = {};\n\n  for (let i = 0; i < header.length; i++) {\n    let 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      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? Number.parseInt(value) : true;\n      key = '';\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      cacheControlValue[key] = NUMERIC_KEYS.has(key) ? Number.parseInt(value) : true;\n    }\n  }\n\n  return cacheControlValue;\n}\n\nfunction isStale(headers: Headers, expirationTime: number): boolean {\n  // const age = headers.get('age');\n  // const cacheControl = parseCacheControl(headers.get('cache-control') || '');\n  // const expires = headers.get('expires');\n  // const lastModified = headers.get('last-modified');\n  const date = headers.get('date');\n\n  if (!date) {\n    return true;\n  }\n\n  const time = new Date(date).getTime();\n  const now = Date.now();\n  const deadline = time + expirationTime;\n\n  const result = now > deadline;\n\n  return result;\n}\n\nexport type LifetimesConfig = { apiCacheSoftExpires: number; apiCacheHardExpires: number };\n\nexport class LifetimesService {\n  declare store: Store;\n  declare config: LifetimesConfig;\n  constructor(store: Store, config: LifetimesConfig) {\n    this.store = store;\n    this.config = config;\n  }\n\n  isHardExpired(identifier: StableDocumentIdentifier): boolean {\n    const cached = this.store.cache.peekRequest(identifier);\n    return !cached || !cached.response || isStale(cached.response.headers, this.config.apiCacheHardExpires);\n  }\n  isSoftExpired(identifier: StableDocumentIdentifier): boolean {\n    const cached = this.store.cache.peekRequest(identifier);\n    return !cached || !cached.response || isStale(cached.response.headers, this.config.apiCacheSoftExpires);\n  }\n}\n"],"names":["CONFIG","host","namespace","setBuildURLConfig","values","OPERATIONS_WITH_PRIMARY_RECORDS","Set","isOperationWithPrimaryRecord","options","has","op","resourcePathForType","identifiers","type","identifier","buildBaseURL","urlOptions","Object","assign","assert","length","Array","isArray","every","i","id","idPath","encodeURIComponent","resourcePath","fieldPath","String","join","includes","endsWith","startsWith","url","filter","Boolean","DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS","arrayFormat","handleInclude","include","split","filterEmpty","obj","result","key","value","sortQueryParams","params","paramsIsObject","URLSearchParams","urlParams","dictionaryParams","forEach","hasExisting","existingValue","push","sortedKeys","keys","sort","v","append","buildQueryParams","toString","NUMERIC_KEYS","parseCacheControl","header","isParsingKey","cacheControlValue","char","charAt","Number","parseInt","isStale","headers","expirationTime","date","get","time","Date","getTime","now","deadline","LifetimesService","constructor","store","config","isHardExpired","cached","cache","peekRequest","response","apiCacheHardExpires","isSoftExpired","apiCacheSoftExpires"],"mappings":";;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AAOA,IAAIA,MAAsB,GAAG;AAC3BC,EAAAA,IAAI,EAAE,EAAE;AACRC,EAAAA,SAAS,EAAE,EAAA;AACb,CAAC,CAAA;AAEM,SAASC,iBAAiBA,CAACC,MAAsB,EAAE;AACxDJ,EAAAA,MAAM,GAAGI,MAAM,CAAA;AACjB,CAAA;AA6EA,MAAMC,+BAA+B,GAAG,IAAIC,GAAG,CAAC,CAC9C,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,cAAc,CACf,CAAC,CAAA;AAEF,SAASC,4BAA4BA,CACnCC,OAAmB,EAMM;AACzB,EAAA,OAAOH,+BAA+B,CAACI,GAAG,CAACD,OAAO,CAACE,EAAE,CAAC,CAAA;AACxD,CAAA;AAEA,SAASC,mBAAmBA,CAACH,OAAmB,EAAU;AACxD,EAAA,OAAOA,OAAO,CAACE,EAAE,KAAK,UAAU,GAAGF,OAAO,CAACI,WAAW,CAAC,CAAC,CAAC,CAACC,IAAI,GAAGL,OAAO,CAACM,UAAU,CAACD,IAAI,CAAA;AAC1F,CAAA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,YAAYA,CAACC,UAAsB,EAAU;AAC3D,EAAA,MAAMR,OAAO,GAAGS,MAAM,CAACC,MAAM,CAC3B;IACEjB,IAAI,EAAED,MAAM,CAACC,IAAI;IACjBC,SAAS,EAAEF,MAAM,CAACE,SAAAA;GACnB,EACDc,UACF,CAAC,CAAA;AACDG,EAAAA,MAAM,CACH,CAA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"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["import { assert, deprecate } from '@ember/debug';\n\nimport type { Cache } from '@warp-drive/core-types/cache';\nimport type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';\nimport type { QueryParamsSerializationOptions, QueryParamsSource, Serializable } from '@warp-drive/core-types/params';\nimport type { ImmutableRequestInfo, ResponseInfo } from '@warp-drive/core-types/request';\n\ntype Store = {\n  cache: Cache;\n};\n\n/**\n * Simple utility function to assist in url building,\n * query params, and other common request operations.\n *\n * These primitives may be used directly or composed\n * by request builders to provide a consistent interface\n * for building requests.\n *\n * For instance:\n *\n * ```ts\n * import { buildBaseURL, buildQueryParams } from '@ember-data/request-utils';\n *\n * const baseURL = buildBaseURL({\n *   host: 'https://api.example.com',\n *   namespace: 'api/v1',\n *   resourcePath: 'emberDevelopers',\n *   op: 'query',\n *   identifier: { type: 'ember-developer' }\n * });\n * const url = `${baseURL}?${buildQueryParams({ name: 'Chris', include:['pets'] })}`;\n * // => 'https://api.example.com/api/v1/emberDevelopers?include=pets&name=Chris'\n * ```\n *\n * This is useful, but not as useful as the REST request builder for query which is sugar\n * over this (and more!):\n *\n * ```ts\n * import { query } from '@ember-data/rest/request';\n *\n * const options = query('ember-developer', { name: 'Chris', include:['pets'] });\n * // => { url: 'https://api.example.com/api/v1/emberDevelopers?include=pets&name=Chris' }\n * // Note: options will also include other request options like headers, method, etc.\n * ```\n *\n * @module @ember-data/request-utils\n * @main @ember-data/request-utils\n * @public\n */\n\n// prevents the final constructed object from needing to add\n// host and namespace which are provided by the final consuming\n// class to the prototype which can result in overwrite errors\n\nexport interface BuildURLConfig {\n  host: string | null;\n  namespace: string | null;\n}\n\nconst CONFIG: BuildURLConfig = {\n  host: '',\n  namespace: '',\n};\n\n/**\n * Sets the global configuration for `buildBaseURL`\n * for host and namespace values for the application.\n *\n * These values may still be overridden by passing\n * them to buildBaseURL directly.\n *\n * This method may be called as many times as needed.\n * host values of `''` or `'/'` are equivalent.\n *\n * Except for the value of `/` as host, host should not\n * end with `/`.\n *\n * namespace should not start or end with a `/`.\n *\n * ```ts\n * type BuildURLConfig = {\n *   host: string;\n *   namespace: string'\n * }\n * ```\n *\n * Example:\n *\n * ```ts\n * import { setBuildURLConfig } from '@ember-data/request-utils';\n *\n * setBuildURLConfig({\n *   host: 'https://api.example.com',\n *   namespace: 'api/v1'\n * });\n * ```\n *\n * @method setBuildURLConfig\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param {BuildURLConfig} config\n * @return void\n */\nexport function setBuildURLConfig(config: BuildURLConfig) {\n  assert(`setBuildURLConfig: You must pass a config object`, config);\n  assert(\n    `setBuildURLConfig: You must pass a config object with a 'host' or 'namespace' property`,\n    'host' in config || 'namespace' in config\n  );\n\n  CONFIG.host = config.host || '';\n  CONFIG.namespace = config.namespace || '';\n\n  assert(\n    `buildBaseURL: host must NOT end with '/', received '${CONFIG.host}'`,\n    CONFIG.host === '/' || !CONFIG.host.endsWith('/')\n  );\n  assert(\n    `buildBaseURL: namespace must NOT start with '/', received '${CONFIG.namespace}'`,\n    !CONFIG.namespace.startsWith('/')\n  );\n  assert(\n    `buildBaseURL: namespace must NOT end with '/', received '${CONFIG.namespace}'`,\n    !CONFIG.namespace.endsWith('/')\n  );\n}\n\nexport interface FindRecordUrlOptions {\n  op: 'findRecord';\n  identifier: { type: string; id: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface QueryUrlOptions {\n  op: 'query';\n  identifier: { type: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface FindManyUrlOptions {\n  op: 'findMany';\n  identifiers: { type: string; id: string }[];\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\nexport interface FindRelatedCollectionUrlOptions {\n  op: 'findRelatedCollection';\n  identifier: { type: string; id: string };\n  fieldPath: string;\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface FindRelatedResourceUrlOptions {\n  op: 'findRelatedRecord';\n  identifier: { type: string; id: string };\n  fieldPath: string;\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface CreateRecordUrlOptions {\n  op: 'createRecord';\n  identifier: { type: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface UpdateRecordUrlOptions {\n  op: 'updateRecord';\n  identifier: { type: string; id: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface DeleteRecordUrlOptions {\n  op: 'deleteRecord';\n  identifier: { type: string; id: string };\n  resourcePath?: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport interface GenericUrlOptions {\n  resourcePath: string;\n  host?: string;\n  namespace?: string;\n}\n\nexport type UrlOptions =\n  | FindRecordUrlOptions\n  | QueryUrlOptions\n  | FindManyUrlOptions\n  | FindRelatedCollectionUrlOptions\n  | FindRelatedResourceUrlOptions\n  | CreateRecordUrlOptions\n  | UpdateRecordUrlOptions\n  | DeleteRecordUrlOptions\n  | GenericUrlOptions;\n\nconst OPERATIONS_WITH_PRIMARY_RECORDS = new Set([\n  'findRecord',\n  'findRelatedRecord',\n  'findRelatedCollection',\n  'updateRecord',\n  'deleteRecord',\n]);\n\nfunction isOperationWithPrimaryRecord(\n  options: UrlOptions\n): options is\n  | FindRecordUrlOptions\n  | FindRelatedCollectionUrlOptions\n  | FindRelatedResourceUrlOptions\n  | UpdateRecordUrlOptions\n  | DeleteRecordUrlOptions {\n  return 'op' in options && OPERATIONS_WITH_PRIMARY_RECORDS.has(options.op);\n}\n\nfunction hasResourcePath(options: UrlOptions): options is GenericUrlOptions {\n  return 'resourcePath' in options && typeof options.resourcePath === 'string' && options.resourcePath.length > 0;\n}\n\nfunction resourcePathForType(options: UrlOptions): string {\n  assert(\n    `resourcePathForType: You must pass a valid op as part of options`,\n    'op' in options && typeof options.op === 'string'\n  );\n  return options.op === 'findMany' ? options.identifiers[0].type : options.identifier.type;\n}\n\n/**\n * Builds a URL for a request based on the provided options.\n * Does not include support for building query params (see `buildQueryParams`)\n * so that it may be composed cleanly with other query-params strategies.\n *\n * Usage:\n *\n * ```ts\n * import { buildBaseURL } from '@ember-data/request-utils';\n *\n * const url = buildBaseURL({\n *   host: 'https://api.example.com',\n *   namespace: 'api/v1',\n *   resourcePath: 'emberDevelopers',\n *   op: 'query',\n *   identifier: { type: 'ember-developer' }\n * });\n *\n * // => 'https://api.example.com/api/v1/emberDevelopers'\n * ```\n *\n * On the surface this may seem like a lot of work to do something simple, but\n * it is designed to be composable with other utilities and interfaces that the\n * average product engineer will never need to see or use.\n *\n * A few notes:\n *\n * - `resourcePath` is optional, but if it is not provided, `identifier.type` will be used.\n * - `host` and `namespace` are optional, but if they are not provided, the values globally\n *    configured via `setBuildURLConfig` will be used.\n * - `op` is required and must be one of the following:\n *   - 'findRecord' 'query' 'findMany' 'findRelatedCollection' 'findRelatedRecord'` 'createRecord' 'updateRecord' 'deleteRecord'\n * - Depending on the value of `op`, `identifier` or `identifiers` will be required.\n *\n * @method buildBaseURL\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param urlOptions\n * @return string\n */\nexport function buildBaseURL(urlOptions: UrlOptions): string {\n  const options = Object.assign(\n    {\n      host: CONFIG.host,\n      namespace: CONFIG.namespace,\n    },\n    urlOptions\n  );\n  assert(\n    `buildBaseURL: You must pass \\`op\\` as part of options`,\n    hasResourcePath(options) || (typeof options.op === 'string' && options.op.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass \\`identifier\\` as part of options`,\n    hasResourcePath(options) ||\n      options.op === 'findMany' ||\n      (options.identifier && typeof options.identifier === 'object')\n  );\n  assert(\n    `buildBaseURL: You must pass \\`identifiers\\` as part of options`,\n    hasResourcePath(options) ||\n      options.op !== 'findMany' ||\n      (options.identifiers &&\n        Array.isArray(options.identifiers) &&\n        options.identifiers.length > 0 &&\n        options.identifiers.every((i) => i && typeof i === 'object'))\n  );\n  assert(\n    `buildBaseURL: You must pass valid \\`identifier\\` as part of options, expected 'id'`,\n    hasResourcePath(options) ||\n      !isOperationWithPrimaryRecord(options) ||\n      (typeof options.identifier.id === 'string' && options.identifier.id.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass \\`identifiers\\` as part of options`,\n    hasResourcePath(options) ||\n      options.op !== 'findMany' ||\n      options.identifiers.every((i) => typeof i.id === 'string' && i.id.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass valid \\`identifier\\` as part of options, expected 'type'`,\n    hasResourcePath(options) ||\n      options.op === 'findMany' ||\n      (typeof options.identifier.type === 'string' && options.identifier.type.length > 0)\n  );\n  assert(\n    `buildBaseURL: You must pass valid \\`identifiers\\` as part of options, expected 'type'`,\n    hasResourcePath(options) ||\n      options.op !== 'findMany' ||\n      (typeof options.identifiers[0].type === 'string' && options.identifiers[0].type.length > 0)\n  );\n\n  // prettier-ignore\n  const idPath: string =\n      isOperationWithPrimaryRecord(options) ? encodeURIComponent(options.identifier.id)\n      : '';\n  const resourcePath = options.resourcePath || resourcePathForType(options);\n  const { host, namespace } = options;\n  const fieldPath = 'fieldPath' in options ? options.fieldPath : '';\n\n  assert(\n    `buildBaseURL: You tried to build a url for a ${String(\n      'op' in options ? options.op + ' ' : ''\n    )}request to ${resourcePath} but resourcePath must be set or op must be one of \"${[\n      'findRecord',\n      'findRelatedRecord',\n      'findRelatedCollection',\n      'updateRecord',\n      'deleteRecord',\n      'createRecord',\n      'query',\n      'findMany',\n    ].join('\",\"')}\".`,\n    hasResourcePath(options) ||\n      [\n        'findRecord',\n        'query',\n        'findMany',\n        'findRelatedCollection',\n        'findRelatedRecord',\n        'createRecord',\n        'updateRecord',\n        'deleteRecord',\n      ].includes(options.op)\n  );\n\n  assert(`buildBaseURL: host must NOT end with '/', received '${host}'`, host === '/' || !host.endsWith('/'));\n  assert(`buildBaseURL: namespace must NOT start with '/', received '${namespace}'`, !namespace.startsWith('/'));\n  assert(`buildBaseURL: namespace must NOT end with '/', received '${namespace}'`, !namespace.endsWith('/'));\n  assert(\n    `buildBaseURL: resourcePath must NOT start with '/', received '${resourcePath}'`,\n    !resourcePath.startsWith('/')\n  );\n  assert(`buildBaseURL: resourcePath must NOT end with '/', received '${resourcePath}'`, !resourcePath.endsWith('/'));\n  assert(`buildBaseURL: fieldPath must NOT start with '/', received '${fieldPath}'`, !fieldPath.startsWith('/'));\n  assert(`buildBaseURL: fieldPath must NOT end with '/', received '${fieldPath}'`, !fieldPath.endsWith('/'));\n  assert(`buildBaseURL: idPath must NOT start with '/', received '${idPath}'`, !idPath.startsWith('/'));\n  assert(`buildBaseURL: idPath must NOT end with '/', received '${idPath}'`, !idPath.endsWith('/'));\n\n  const hasHost = host !== '' && host !== '/';\n  const url = [hasHost ? host : '', namespace, resourcePath, idPath, fieldPath].filter(Boolean).join('/');\n  return hasHost ? url : `/${url}`;\n}\n\nconst DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS: QueryParamsSerializationOptions = {\n  arrayFormat: 'comma',\n};\n\nfunction handleInclude(include: string | string[]): string[] {\n  assert(\n    `Expected include to be a string or array, got ${typeof include}`,\n    typeof include === 'string' || Array.isArray(include)\n  );\n  return typeof include === 'string' ? include.split(',') : include;\n}\n\n/**\n * filter out keys of an object that have falsy values or point to empty arrays\n * returning a new object with only those keys that have truthy values / non-empty arrays\n *\n * @method filterEmpty\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param {Record<string, Serializable>} source object to filter keys with empty values from\n * @return {Record<string, Serializable>} A new object with the keys that contained empty values removed\n */\nexport function filterEmpty(source: Record<string, Serializable>): Record<string, Serializable> {\n  const result: Record<string, Serializable> = {};\n  for (const key in source) {\n    const value = source[key];\n    // Allow `0` and `false` but filter falsy values that indicate \"empty\"\n    if (value !== undefined && value !== null && value !== '') {\n      if (!Array.isArray(value) || value.length > 0) {\n        result[key] = source[key];\n      }\n    }\n  }\n  return result;\n}\n\n/**\n * Sorts query params by both key and value returning a new URLSearchParams\n * object with the keys inserted in sorted order.\n *\n * Treats `included` specially, splicing it into an array if it is a string and sorting the array.\n *\n * Options:\n * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'\n *\n * 'bracket': appends [] to the key for every value e.g. `&ids[]=1&ids[]=2`\n * 'indices': appends [i] to the key for every value e.g. `&ids[0]=1&ids[1]=2`\n * 'repeat': appends the key for every value e.g. `&ids=1&ids=2`\n * 'comma' (default): appends the key once with a comma separated list of values e.g. `&ids=1,2`\n *\n * @method sortQueryParams\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param {URLSearchParams | object} params\n * @param {object} options\n * @return {URLSearchParams} A URLSearchParams with keys inserted in sorted order\n */\nexport function sortQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): URLSearchParams {\n  const opts = Object.assign({}, DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS, options);\n  const paramsIsObject = !(params instanceof URLSearchParams);\n  const urlParams = new URLSearchParams();\n  const dictionaryParams: Record<string, Serializable> = paramsIsObject ? params : {};\n\n  if (!paramsIsObject) {\n    params.forEach((value, key) => {\n      const hasExisting = key in dictionaryParams;\n      if (!hasExisting) {\n        dictionaryParams[key] = value;\n      } else {\n        const existingValue = dictionaryParams[key];\n        if (Array.isArray(existingValue)) {\n          existingValue.push(value);\n        } else {\n          dictionaryParams[key] = [existingValue, value];\n        }\n      }\n    });\n  }\n\n  if ('include' in dictionaryParams) {\n    dictionaryParams.include = handleInclude(dictionaryParams.include as string | string[]);\n  }\n\n  const sortedKeys = Object.keys(dictionaryParams).sort();\n  sortedKeys.forEach((key) => {\n    const value = dictionaryParams[key];\n    if (Array.isArray(value)) {\n      value.sort();\n      switch (opts.arrayFormat) {\n        case 'indices':\n          value.forEach((v, i) => {\n            urlParams.append(`${key}[${i}]`, String(v));\n          });\n          return;\n        case 'bracket':\n          value.forEach((v) => {\n            urlParams.append(`${key}[]`, String(v));\n          });\n          return;\n        case 'repeat':\n          value.forEach((v) => {\n            urlParams.append(key, String(v));\n          });\n          return;\n        case 'comma':\n        default:\n          urlParams.append(key, value.join(','));\n          return;\n      }\n    } else {\n      urlParams.append(key, String(value));\n    }\n  });\n\n  return urlParams;\n}\n\n/**\n * Sorts query params by both key and value, returning a query params string\n *\n * Treats `included` specially, splicing it into an array if it is a string and sorting the array.\n *\n * Options:\n * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'\n *\n * 'bracket': appends [] to the key for every value e.g. `ids[]=1&ids[]=2`\n * 'indices': appends [i] to the key for every value e.g. `ids[0]=1&ids[1]=2`\n * 'repeat': appends the key for every value e.g. `ids=1&ids=2`\n * 'comma' (default): appends the key once with a comma separated list of values e.g. `ids=1,2`\n *\n * @method buildQueryParams\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param {URLSearchParams | object} params\n * @param {object} [options]\n * @return {string} A sorted query params string without the leading `?`\n */\nexport function buildQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): string {\n  return sortQueryParams(params, options).toString();\n}\nexport 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\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 * @method parseCacheControl\n * @static\n * @public\n * @for @ember-data/request-utils\n * @param {string} header\n * @return {CacheControlValue}\n */\nexport function parseCacheControl(header: string): CacheControlValue {\n  let key: CacheControlKey = '' as CacheControlKey;\n  let value = '';\n  let isParsingKey = true;\n  const cacheControlValue: CacheControlValue = {};\n\n  function 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    return parsedValue;\n  }\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}\n\nfunction isStale(headers: Headers, expirationTime: number): boolean {\n  // const age = headers.get('age');\n  // const cacheControl = parseCacheControl(headers.get('cache-control') || '');\n  // const expires = headers.get('expires');\n  // const lastModified = headers.get('last-modified');\n  const date = headers.get('date');\n\n  if (!date) {\n    return true;\n  }\n\n  const time = new Date(date).getTime();\n  const now = Date.now();\n  const deadline = time + expirationTime;\n\n  const result = now > deadline;\n\n  return result;\n}\n\nexport type LifetimesConfig = { apiCacheSoftExpires: number; apiCacheHardExpires: number };\n\n/**\n * A basic LifetimesService that can be added to the Store service.\n *\n * Determines staleness based on time since the request was last received from the API\n * using the `date` header.\n *\n * Invalidates any request for which `cacheOptions.types` was provided when a createRecord\n * request for that type is successful.\n *\n * For this to work, the `createRecord` request must include the `cacheOptions.types` array\n * with the types that should be invalidated, or its request should specify the identifiers\n * of the records that are being created via `records`. Providing both is valid.\n *\n * > [!NOTE]\n * > only requests that had specified `cacheOptions.types` and occurred prior to the\n * > createRecord request will be invalidated. This means that a given request should always\n * > specify the types that would invalidate it to opt into this behavior. Abstracting this\n * > behavior via builders is recommended to ensure consistency.\n *\n * This allows the Store's CacheHandler to determine if a request is expired and\n * should be refetched upon next request.\n *\n * The `Fetch` handler provided by `@ember-data/request/fetch` will automatically\n * add the `date` header to responses if it is not present.\n *\n * > [!NOTE]\n * > Date headers do not have millisecond precision, so expiration times should\n * > generally be larger than 1000ms.\n *\n * Usage:\n *\n * ```ts\n * import { LifetimesService } from '@ember-data/request-utils';\n * import DataStore from '@ember-data/store';\n *\n * // ...\n *\n * export class Store extends DataStore {\n *   constructor(args) {\n *     super(args);\n *     this.lifetimes = new LifetimesService({ apiCacheSoftExpires: 30_000, apiCacheHardExpires: 60_000 });\n *   }\n * }\n * ```\n *\n * @class LifetimesService\n * @public\n * @module @ember-data/request-utils\n */\nexport class LifetimesService {\n  declare config: LifetimesConfig;\n  declare _stores: WeakMap<Store, { invalidated: Set<string>; types: Map<string, Set<string>> }>;\n\n  _getStore(store: Store): { invalidated: Set<string>; types: Map<string, Set<string>> } {\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: LifetimesConfig) {\n    this._stores = new WeakMap();\n\n    const _config = arguments.length === 1 ? config : (arguments[1] as unknown as LifetimesConfig);\n    deprecate(\n      `Passing a Store to the LifetimesService is deprecated, please pass only a config instead.`,\n      arguments.length === 1,\n      {\n        id: 'ember-data:request-utils:lifetimes-service-store-arg',\n        since: {\n          enabled: '5.4',\n          available: '5.4',\n        },\n        for: '@ember-data/request-utils',\n        until: '6.0',\n      }\n    );\n    assert(`You must pass a config to the LifetimesService`, _config);\n    assert(\n      `You must pass a apiCacheSoftExpires to the LifetimesService`,\n      typeof _config.apiCacheSoftExpires === 'number'\n    );\n    assert(\n      `You must pass a apiCacheHardExpires to the LifetimesService`,\n      typeof _config.apiCacheHardExpires === 'number'\n    );\n    this.config = _config;\n  }\n\n  /**\n   * Invalidate a request by its identifier for a given store instance.\n   *\n   * While the store argument may seem redundant, the lifetimes service\n   * is designed to be shared across multiple stores / forks\n   * of the store.\n   *\n   * ```ts\n   * store.lifetimes.invalidateRequest(store, identifier);\n   * ```\n   *\n   * @method invalidateRequest\n   * @public\n   * @param {StableDocumentIdentifier} identifier\n   * @param {Store} store\n   */\n  invalidateRequest(identifier: StableDocumentIdentifier, store: Store): void {\n    this._getStore(store).invalidated.add(identifier.lid);\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 lifetimes service\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 CacheHandler and the LegacyNetworkHandler.\n   *\n   * ```ts\n   * store.lifetimes.invalidateRequestsForType(store, 'person');\n   * ```\n   *\n   * @method invalidateRequestsForType\n   * @public\n   * @param {string} type\n   * @param {Store} store\n   */\n  invalidateRequestsForType(type: string, store: Store): void {\n    const storeCache = this._getStore(store);\n    const set = storeCache.types.get(type);\n    if (set) {\n      set.forEach((id) => {\n        storeCache.invalidated.add(id);\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 CacheHandler regardless of whether\n   * the request has a cache-key.\n   *\n   * This method should not be invoked directly by consumers.\n   *\n   * @method didRequest\n   * @public\n   * @param {ImmutableRequestInfo} request\n   * @param {ImmutableResponse} response\n   * @param {Store} store\n   * @param {StableDocumentIdentifier | null} identifier\n   * @return {void}\n   */\n  didRequest(\n    request: ImmutableRequestInfo,\n    response: Response | ResponseInfo | null,\n    identifier: StableDocumentIdentifier | 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 (identifier && 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(identifier.lid);\n          storeCache.invalidated.delete(identifier.lid);\n        } else {\n          storeCache.types.set(type, new Set([identifier.lid]));\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 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   * @method isHardExpired\n   * @public\n   * @param {StableDocumentIdentifier} identifier\n   * @param {Store} store\n   * @return {boolean} true if the request is considered hard expired\n   */\n  isHardExpired(identifier: StableDocumentIdentifier, store: Store): boolean {\n    // if we are explicitly invalidated, we are hard expired\n    const storeCache = this._getStore(store);\n    if (storeCache.invalidated.has(identifier.lid)) {\n      return true;\n    }\n    const cache = store.cache;\n    const cached = cache.peekRequest(identifier);\n    return !cached || !cached.response || isStale(cached.response.headers, this.config.apiCacheHardExpires);\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 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   * @method isSoftExpired\n   * @public\n   * @param {StableDocumentIdentifier} identifier\n   * @param {Store} store\n   * @return {boolean} true if the request is considered soft expired\n   */\n  isSoftExpired(identifier: StableDocumentIdentifier, store: Store): boolean {\n    const cache = store.cache;\n    const cached = cache.peekRequest(identifier);\n    return !cached || !cached.response || isStale(cached.response.headers, this.config.apiCacheSoftExpires);\n  }\n}\n"],"names":["CONFIG","host","namespace","setBuildURLConfig","config","assert","endsWith","startsWith","OPERATIONS_WITH_PRIMARY_RECORDS","Set","isOperationWithPrimaryRecord","options","has","op","hasResourcePath","resourcePath","length","resourcePathForType","identifiers","type","identifier","buildBaseURL","urlOptions","Object","assign","Array","isArray","every","i","id","idPath","encodeURIComponent","fieldPath","String","join","includes","hasHost","url","filter","Boolean","DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS","arrayFormat","handleInclude","include","split","filterEmpty","source","result","key","value","undefined","sortQueryParams","params","opts","paramsIsObject","URLSearchParams","urlParams","dictionaryParams","forEach","hasExisting","existingValue","push","sortedKeys","keys","sort","v","append","buildQueryParams","toString","NUMERIC_KEYS","parseCacheControl","header","isParsingKey","cacheControlValue","parseCacheControlValue","stringToParse","parsedValue","Number","parseInt","isNaN","char","charAt","isStale","headers","expirationTime","date","get","time","Date","getTime","now","deadline","LifetimesService","_getStore","store","set","_stores","invalidated","types","Map","constructor","WeakMap","_config","arguments","deprecate","since","enabled","available","for","until","apiCacheSoftExpires","apiCacheHardExpires","invalidateRequest","add","lid","invalidateRequestsForType","storeCache","didRequest","request","response","statusNumber","status","records","map","r","additionalTypes","cacheOptions","delete","isHardExpired","cache","cached","peekRequest","isSoftExpired"],"mappings":";;AAWA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAOA,MAAMA,MAAsB,GAAG;AAC7BC,EAAAA,IAAI,EAAE,EAAE;AACRC,EAAAA,SAAS,EAAE,EAAA;AACb,CAAC,CAAA;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,iBAAiBA,CAACC,MAAsB,EAAE;AACxDC,EAAAA,MAAM,CAAE,CAAA,gDAAA,CAAiD,EAAED,MAAM,CAAC,CAAA;EAClEC,MAAM,CACH,CAAuF,sFAAA,CAAA,EACxF,MAAM,IAAID,MAAM,IAAI,WAAW,IAAIA,MACrC,CAAC,CAAA;AAEDJ,EAAAA,MAAM,CAACC,IAAI,GAAGG,MAAM,CAACH,IAAI,IAAI,EAAE,CAAA;AAC/BD,EAAAA,MAAM,CAACE,SAAS,GAAGE,MAAM,CAACF,SAAS,IAAI,EAAE,CAAA;EAEzCG,MAAM,CACH,uDAAsDL,MAAM,CAACC,IAAK,CAAE,CAAA,CAAA,EACrED,MAAM,CAACC,IAAI,KAAK,GAAG,IAAI,CAACD,MAAM,CAACC,IAAI,CAACK,QAAQ,CAAC,GAAG,CAClD,CAAC,CAAA;AACDD,EAAAA,MAAM,CACH,CAA6DL,2DAAAA,EAAAA,MAAM,CAACE,SAAU,GAAE,EACjF,CAACF,MAAM,CAACE,SAAS,CAACK,UAAU,CAAC,GAAG,CAClC,CAAC,CAAA;AACDF,EAAAA,MAAM,CACH,CAA2DL,yDAAAA,EAAAA,MAAM,CAACE,SAAU,GAAE,EAC/E,CAACF,MAAM,CAACE,SAAS,CAACI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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ember-data/request-utils",
   "description": "Request Building Utilities for use with EmberData",
-  "version": "5.4.0-alpha.5",
+  "version": "5.4.0-alpha.50",
   "private": false,
   "license": "MIT",
   "author": "Chris Thoburn <runspired@users.noreply.github.com>",
@@ -13,7 +13,7 @@
   "homepage": "https://github.com/emberjs/data",
   "bugs": "https://github.com/emberjs/data/issues",
   "engines": {
-    "node": "16.* || >= 18"
+    "node": ">= 18.19.1"
   },
   "keywords": [
     "ember-addon"
@@ -21,10 +21,14 @@
   "volta": {
     "extends": "../../package.json"
   },
+  "peerDependencies": {
+    "@warp-drive/core-types": "0.0.0-alpha.36"
+  },
   "dependencies": {
-    "ember-cli-babel": "^8.0.0"
+    "ember-cli-babel": "^8.2.0"
   },
   "files": [
+    "unstable-preview-types",
     "addon-main.js",
     "addon",
     "README.md",
@@ -32,34 +36,46 @@
     "ember-data-logo-dark.svg",
     "ember-data-logo-light.svg"
   ],
+  "scripts": {
+    "lint": "eslint . --quiet --cache --cache-strategy=content --ext .js,.ts,.mjs,.cjs --report-unused-disable-directives",
+    "build:types": "tsc --build",
+    "build:client": "rollup --config && babel ./addon --out-dir addon --plugins=../private-build-infra/src/transforms/babel-plugin-transform-ext.js",
+    "_build": "bun run build:client && bun run build:types",
+    "_syncPnpm": "bun run sync-dependencies-meta-injected"
+  },
   "ember-addon": {
     "main": "addon-main.js",
     "type": "addon",
     "version": 1
   },
   "devDependencies": {
-    "@babel/cli": "^7.22.10",
-    "@babel/core": "^7.22.11",
-    "@babel/plugin-proposal-decorators": "^7.22.10",
-    "@babel/plugin-transform-class-properties": "^7.22.5",
-    "@babel/plugin-transform-runtime": "^7.22.10",
-    "@babel/plugin-transform-typescript": "^7.22.11",
-    "@babel/preset-env": "^7.22.10",
-    "@babel/preset-typescript": "^7.22.11",
-    "@babel/runtime": "^7.22.11",
-    "@embroider/addon-dev": "^4.1.0",
-    "@rollup/plugin-babel": "^6.0.3",
-    "@rollup/plugin-node-resolve": "^15.2.1",
-    "rollup": "^3.28.1",
-    "tslib": "^2.6.2",
-    "typescript": "^5.2.2",
+    "@babel/cli": "^7.24.1",
+    "@babel/core": "^7.24.3",
+    "@babel/plugin-proposal-decorators": "^7.24.1",
+    "@babel/plugin-transform-class-properties": "^7.24.1",
+    "@babel/plugin-transform-runtime": "^7.24.3",
+    "@babel/plugin-transform-typescript": "^7.24.1",
+    "@babel/preset-env": "^7.24.3",
+    "@babel/preset-typescript": "^7.24.1",
+    "@babel/runtime": "^7.24.1",
+    "@embroider/addon-dev": "^4.2.1",
+    "@glimmer/component": "^1.1.2",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@warp-drive/core-types": "0.0.0-alpha.36",
+    "@warp-drive/internal-config": "5.4.0-alpha.50",
+    "ember-source": "~5.7.0",
+    "pnpm-sync-dependencies-meta-injected": "0.0.10",
+    "rollup": "^4.13.0",
+    "typescript": "^5.4.3",
     "walk-sync": "^3.0.0"
   },
   "ember": {
     "edition": "octane"
   },
-  "scripts": {
-    "build": "rollup --config && babel ./addon --out-dir addon --plugins=../private-build-infra/src/transforms/babel-plugin-transform-ext.js",
-    "start": "rollup --config --watch"
+  "dependenciesMeta": {
+    "@warp-drive/core-types": {
+      "injected": true
+    }
   }
-}
+}

package/unstable-preview-types/index.d.ts

@@ -0,0 +1,483 @@
+
+declare module '@ember-data/request-utils' {
+  import type { Cache } from '@warp-drive/core-types/cache';
+  import type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';
+  import type { QueryParamsSerializationOptions, QueryParamsSource, Serializable } from '@warp-drive/core-types/params';
+  import type { ImmutableRequestInfo, ResponseInfo } from '@warp-drive/core-types/request';
+  type Store = {
+      cache: Cache;
+  };
+  /**
+   * Simple utility function to assist in url building,
+   * query params, and other common request operations.
+   *
+   * These primitives may be used directly or composed
+   * by request builders to provide a consistent interface
+   * for building requests.
+   *
+   * For instance:
+   *
+   * ```ts
+   * import { buildBaseURL, buildQueryParams } from '@ember-data/request-utils';
+   *
+   * const baseURL = buildBaseURL({
+   *   host: 'https://api.example.com',
+   *   namespace: 'api/v1',
+   *   resourcePath: 'emberDevelopers',
+   *   op: 'query',
+   *   identifier: { type: 'ember-developer' }
+   * });
+   * const url = `${baseURL}?${buildQueryParams({ name: 'Chris', include:['pets'] })}`;
+   * // => 'https://api.example.com/api/v1/emberDevelopers?include=pets&name=Chris'
+   * ```
+   *
+   * This is useful, but not as useful as the REST request builder for query which is sugar
+   * over this (and more!):
+   *
+   * ```ts
+   * import { query } from '@ember-data/rest/request';
+   *
+   * const options = query('ember-developer', { name: 'Chris', include:['pets'] });
+   * // => { url: 'https://api.example.com/api/v1/emberDevelopers?include=pets&name=Chris' }
+   * // Note: options will also include other request options like headers, method, etc.
+   * ```
+   *
+   * @module @ember-data/request-utils
+   * @main @ember-data/request-utils
+   * @public
+   */
+  export interface BuildURLConfig {
+      host: string | null;
+      namespace: string | null;
+  }
+  /**
+   * Sets the global configuration for `buildBaseURL`
+   * for host and namespace values for the application.
+   *
+   * These values may still be overridden by passing
+   * them to buildBaseURL directly.
+   *
+   * This method may be called as many times as needed.
+   * host values of `''` or `'/'` are equivalent.
+   *
+   * Except for the value of `/` as host, host should not
+   * end with `/`.
+   *
+   * namespace should not start or end with a `/`.
+   *
+   * ```ts
+   * type BuildURLConfig = {
+   *   host: string;
+   *   namespace: string'
+   * }
+   * ```
+   *
+   * Example:
+   *
+   * ```ts
+   * import { setBuildURLConfig } from '@ember-data/request-utils';
+   *
+   * setBuildURLConfig({
+   *   host: 'https://api.example.com',
+   *   namespace: 'api/v1'
+   * });
+   * ```
+   *
+   * @method setBuildURLConfig
+   * @static
+   * @public
+   * @for @ember-data/request-utils
+   * @param {BuildURLConfig} config
+   * @return void
+   */
+  export function setBuildURLConfig(config: BuildURLConfig): void;
+  export interface FindRecordUrlOptions {
+      op: 'findRecord';
+      identifier: {
+          type: string;
+          id: string;
+      };
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface QueryUrlOptions {
+      op: 'query';
+      identifier: {
+          type: string;
+      };
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface FindManyUrlOptions {
+      op: 'findMany';
+      identifiers: {
+          type: string;
+          id: string;
+      }[];
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface FindRelatedCollectionUrlOptions {
+      op: 'findRelatedCollection';
+      identifier: {
+          type: string;
+          id: string;
+      };
+      fieldPath: string;
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface FindRelatedResourceUrlOptions {
+      op: 'findRelatedRecord';
+      identifier: {
+          type: string;
+          id: string;
+      };
+      fieldPath: string;
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface CreateRecordUrlOptions {
+      op: 'createRecord';
+      identifier: {
+          type: string;
+      };
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface UpdateRecordUrlOptions {
+      op: 'updateRecord';
+      identifier: {
+          type: string;
+          id: string;
+      };
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface DeleteRecordUrlOptions {
+      op: 'deleteRecord';
+      identifier: {
+          type: string;
+          id: string;
+      };
+      resourcePath?: string;
+      host?: string;
+      namespace?: string;
+  }
+  export interface GenericUrlOptions {
+      resourcePath: string;
+      host?: string;
+      namespace?: string;
+  }
+  export type UrlOptions = FindRecordUrlOptions | QueryUrlOptions | FindManyUrlOptions | FindRelatedCollectionUrlOptions | FindRelatedResourceUrlOptions | CreateRecordUrlOptions | UpdateRecordUrlOptions | DeleteRecordUrlOptions | GenericUrlOptions;
+  /**
+   * Builds a URL for a request based on the provided options.
+   * Does not include support for building query params (see `buildQueryParams`)
+   * so that it may be composed cleanly with other query-params strategies.
+   *
+   * Usage:
+   *
+   * ```ts
+   * import { buildBaseURL } from '@ember-data/request-utils';
+   *
+   * const url = buildBaseURL({
+   *   host: 'https://api.example.com',
+   *   namespace: 'api/v1',
+   *   resourcePath: 'emberDevelopers',
+   *   op: 'query',
+   *   identifier: { type: 'ember-developer' }
+   * });
+   *
+   * // => 'https://api.example.com/api/v1/emberDevelopers'
+   * ```
+   *
+   * On the surface this may seem like a lot of work to do something simple, but
+   * it is designed to be composable with other utilities and interfaces that the
+   * average product engineer will never need to see or use.
+   *
+   * A few notes:
+   *
+   * - `resourcePath` is optional, but if it is not provided, `identifier.type` will be used.
+   * - `host` and `namespace` are optional, but if they are not provided, the values globally
+   *    configured via `setBuildURLConfig` will be used.
+   * - `op` is required and must be one of the following:
+   *   - 'findRecord' 'query' 'findMany' 'findRelatedCollection' 'findRelatedRecord'` 'createRecord' 'updateRecord' 'deleteRecord'
+   * - Depending on the value of `op`, `identifier` or `identifiers` will be required.
+   *
+   * @method buildBaseURL
+   * @static
+   * @public
+   * @for @ember-data/request-utils
+   * @param urlOptions
+   * @return string
+   */
+  export function buildBaseURL(urlOptions: UrlOptions): string;
+  /**
+   * filter out keys of an object that have falsy values or point to empty arrays
+   * returning a new object with only those keys that have truthy values / non-empty arrays
+   *
+   * @method filterEmpty
+   * @static
+   * @public
+   * @for @ember-data/request-utils
+   * @param {Record<string, Serializable>} source object to filter keys with empty values from
+   * @return {Record<string, Serializable>} A new object with the keys that contained empty values removed
+   */
+  export function filterEmpty(source: Record<string, Serializable>): Record<string, Serializable>;
+  /**
+   * Sorts query params by both key and value returning a new URLSearchParams
+   * object with the keys inserted in sorted order.
+   *
+   * Treats `included` specially, splicing it into an array if it is a string and sorting the array.
+   *
+   * Options:
+   * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
+   *
+   * 'bracket': appends [] to the key for every value e.g. `&ids[]=1&ids[]=2`
+   * 'indices': appends [i] to the key for every value e.g. `&ids[0]=1&ids[1]=2`
+   * 'repeat': appends the key for every value e.g. `&ids=1&ids=2`
+   * 'comma' (default): appends the key once with a comma separated list of values e.g. `&ids=1,2`
+   *
+   * @method sortQueryParams
+   * @static
+   * @public
+   * @for @ember-data/request-utils
+   * @param {URLSearchParams | object} params
+   * @param {object} options
+   * @return {URLSearchParams} A URLSearchParams with keys inserted in sorted order
+   */
+  export function sortQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): URLSearchParams;
+  /**
+   * Sorts query params by both key and value, returning a query params string
+   *
+   * Treats `included` specially, splicing it into an array if it is a string and sorting the array.
+   *
+   * Options:
+   * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
+   *
+   * 'bracket': appends [] to the key for every value e.g. `ids[]=1&ids[]=2`
+   * 'indices': appends [i] to the key for every value e.g. `ids[0]=1&ids[1]=2`
+   * 'repeat': appends the key for every value e.g. `ids=1&ids=2`
+   * 'comma' (default): appends the key once with a comma separated list of values e.g. `ids=1,2`
+   *
+   * @method buildQueryParams
+   * @static
+   * @public
+   * @for @ember-data/request-utils
+   * @param {URLSearchParams | object} params
+   * @param {object} [options]
+   * @return {string} A sorted query params string without the leading `?`
+   */
+  export function buildQueryParams(params: QueryParamsSource, options?: QueryParamsSerializationOptions): string;
+  export 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;
+  }
+  /**
+   *  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;
+   * }
+   * ```
+   * @method parseCacheControl
+   * @static
+   * @public
+   * @for @ember-data/request-utils
+   * @param {string} header
+   * @return {CacheControlValue}
+   */
+  export function parseCacheControl(header: string): CacheControlValue;
+  export type LifetimesConfig = {
+      apiCacheSoftExpires: number;
+      apiCacheHardExpires: number;
+  };
+  /**
+   * A basic LifetimesService 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.
+   *
+   * 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 identifiers
+   * 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 `@ember-data/request/fetch` 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 { LifetimesService } from '@ember-data/request-utils';
+   * import DataStore from '@ember-data/store';
+   *
+   * // ...
+   *
+   * export class Store extends DataStore {
+   *   constructor(args) {
+   *     super(args);
+   *     this.lifetimes = new LifetimesService({ apiCacheSoftExpires: 30_000, apiCacheHardExpires: 60_000 });
+   *   }
+   * }
+   * ```
+   *
+   * @class LifetimesService
+   * @public
+   * @module @ember-data/request-utils
+   */
+  export class LifetimesService {
+      config: LifetimesConfig;
+      _stores: WeakMap<Store, {
+          invalidated: Set<string>;
+          types: Map<string, Set<string>>;
+      }>;
+      _getStore(store: Store): {
+          invalidated: Set<string>;
+          types: Map<string, Set<string>>;
+      };
+      constructor(config: LifetimesConfig);
+      /**
+       * Invalidate a request by its identifier for a given store instance.
+       *
+       * While the store argument may seem redundant, the lifetimes service
+       * is designed to be shared across multiple stores / forks
+       * of the store.
+       *
+       * ```ts
+       * store.lifetimes.invalidateRequest(store, identifier);
+       * ```
+       *
+       * @method invalidateRequest
+       * @public
+       * @param {StableDocumentIdentifier} identifier
+       * @param {Store} store
+       */
+      invalidateRequest(identifier: StableDocumentIdentifier, store: Store): void;
+      /**
+       * Invalidate all requests associated to a specific type
+       * for a given store instance.
+       *
+       * While the store argument may seem redundant, the lifetimes service
+       * 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');
+       * ```
+       *
+       * @method invalidateRequestsForType
+       * @public
+       * @param {string} type
+       * @param {Store} store
+       */
+      invalidateRequestsForType(type: string, store: Store): void;
+      /**
+       * 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.
+       *
+       * @method didRequest
+       * @public
+       * @param {ImmutableRequestInfo} request
+       * @param {ImmutableResponse} response
+       * @param {Store} store
+       * @param {StableDocumentIdentifier | null} identifier
+       * @return {void}
+       */
+      didRequest(request: ImmutableRequestInfo, response: Response | ResponseInfo | null, identifier: StableDocumentIdentifier | null, store: Store): void;
+      /**
+       * 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.
+       *
+       * @method isHardExpired
+       * @public
+       * @param {StableDocumentIdentifier} identifier
+       * @param {Store} store
+       * @return {boolean} true if the request is considered hard expired
+       */
+      isHardExpired(identifier: StableDocumentIdentifier, store: Store): boolean;
+      /**
+       * 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.
+       *
+       * @method isSoftExpired
+       * @public
+       * @param {StableDocumentIdentifier} identifier
+       * @param {Store} store
+       * @return {boolean} true if the request is considered soft expired
+       */
+      isSoftExpired(identifier: StableDocumentIdentifier, store: Store): boolean;
+  }
+  export {};
+}
+//# sourceMappingURL=index.d.ts.map

package/unstable-preview-types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}