@ember-data/request-utils 5.4.0-beta.0 → 5.4.0-beta.10

package/unstable-preview-types/-private/string/inflect.d.ts

@@ -0,0 +1,14 @@
+declare module '@ember-data/request-utils/-private/string/inflect' {
+  export function uncountable(word: string): void;
+  export function loadUncountable(uncountables: string[]): void;
+  export function irregular(single: string, plur: string): void;
+  export function loadIrregular(irregularPairs: Array<[string, string]>): void;
+  export function clear(): void;
+  export function resetToDefaults(): void;
+  export function clearRules(): void;
+  export function singularize(word: string): string;
+  export function pluralize(word: string): string;
+  export function plural(regex: RegExp, string: string): void;
+  export function singular(regex: RegExp, string: string): void;
+}
+//# sourceMappingURL=inflect.d.ts.map

package/unstable-preview-types/-private/string/inflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflect.d.ts","sourceRoot":"","sources":["../../../src/-private/string/inflect.ts"],"names":[],"mappings":"AAsBA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,QAEvC;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAIrD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAQrD;AAED,wBAAgB,aAAa,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAUpE;AAGD,wBAAgB,KAAK,SAGpB;AAED,wBAAgB,eAAe,SAM9B;AAED,wBAAgB,UAAU,SAQzB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,UAIvC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,UAIrC;AAWD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAQnD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAQrD"}

package/unstable-preview-types/-private/string/inflections.d.ts

@@ -0,0 +1,12 @@
+declare module '@ember-data/request-utils/-private/string/inflections' {
+  export type RulesArray = Array<[RegExp, string]>;
+  type DefaultRulesType = {
+      plurals: RulesArray;
+      singular: RulesArray;
+      irregularPairs: Array<[string, string]>;
+      uncountable: string[];
+  };
+  export const defaultRules: DefaultRulesType;
+  export {};
+}
+//# sourceMappingURL=inflections.d.ts.map

package/unstable-preview-types/-private/string/inflections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflections.d.ts","sourceRoot":"","sources":["../../../src/-private/string/inflections.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACjD,KAAK,gBAAgB,GAAG;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,UAAU,CAAC;IACrB,cAAc,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,gBAkE1B,CAAC"}

package/unstable-preview-types/-private/string/transform.d.ts

@@ -0,0 +1,81 @@
+declare module '@ember-data/request-utils/-private/string/transform' {
+  export class LRUCache<T, V> {
+      size: number;
+      state: Map<T, V>;
+      doWork: (k: T) => V;
+      _hits: number;
+      _misses: number;
+      _ejected: number;
+      constructor(doWork: (k: T) => V, size?: number);
+      get(key: T): V;
+      set(key: T, value: V): void;
+      clear(): void;
+  }
+  /**
+    Replaces underscores, spaces, or camelCase with dashes.
+  
+    ```js
+    import { dasherize } from '@ember-data/request-utils/string';
+  
+    dasherize('innerHTML');                // 'inner-html'
+    dasherize('action_name');              // 'action-name'
+    dasherize('css-class-name');           // 'css-class-name'
+    dasherize('my favorite items');        // 'my-favorite-items'
+    dasherize('privateDocs/ownerInvoice';  // 'private-docs/owner-invoice'
+    ```
+  
+    @typedoc
+  */
+  export function dasherize(str: string): string;
+  /**
+    Returns the lowerCamelCase form of a string.
+  
+    ```js
+    import { camelize } from '@ember-data/request-utils/string';
+  
+    camelize('innerHTML');                   // 'innerHTML'
+    camelize('action_name');                 // 'actionName'
+    camelize('css-class-name');              // 'cssClassName'
+    camelize('my favorite items');           // 'myFavoriteItems'
+    camelize('My Favorite Items');           // 'myFavoriteItems'
+    camelize('private-docs/owner-invoice');  // 'privateDocs/ownerInvoice'
+  ```
+  
+    @typedoc
+  */
+  export function camelize(str: string): string;
+  /**
+    Returns the lower\_case\_and\_underscored form of a string.
+  
+    ```js
+    import { underscore } from '@ember-data/request-utils/string';
+  
+    underscore('innerHTML');                 // 'inner_html'
+    underscore('action_name');               // 'action_name'
+    underscore('css-class-name');            // 'css_class_name'
+    underscore('my favorite items');         // 'my_favorite_items'
+    underscore('privateDocs/ownerInvoice');  // 'private_docs/owner_invoice'
+    ```
+  
+    @typedoc
+  */
+  export function underscore(str: string): string;
+  /**
+    Returns the Capitalized form of a string
+  
+    ```js
+    import { capitalize } from '@ember-data/request-utils/string';
+  
+    capitalize('innerHTML')                 // 'InnerHTML'
+    capitalize('action_name')               // 'Action_name'
+    capitalize('css-class-name')            // 'Css-class-name'
+    capitalize('my favorite items')         // 'My favorite items'
+    capitalize('privateDocs/ownerInvoice'); // 'PrivateDocs/ownerInvoice'
+    ```
+  
+    @typedoc
+  */
+  export function capitalize(str: string): string;
+  export function setMaxLRUCacheSize(size: number): void;
+}
+//# sourceMappingURL=transform.d.ts.map

package/unstable-preview-types/-private/string/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/-private/string/transform.ts"],"names":[],"mappings":"AAGA,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IAGpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM;IAW9C,GAAG,CAAC,GAAG,EAAE,CAAC;IAmBV,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAapB,KAAK;CAQN;AA6BD;;;;;;;;;;;;;;EAcE;AACF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;;;;;;;;;EAeE;AACF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;;;;EAcE;AACF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;;;;;;;;;;;EAcE;AACF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,QAK9C"}

package/unstable-preview-types/deprecation-support.d.ts

@@ -0,0 +1,4 @@
+declare module '@ember-data/request-utils/deprecation-support' {
+  export {};
+}
+//# sourceMappingURL=deprecation-support.d.ts.map

package/unstable-preview-types/deprecation-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation-support.d.ts","sourceRoot":"","sources":["../src/deprecation-support.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,490 @@
+/// <reference path="./string.d.ts" />
+/// <reference path="./deprecation-support.d.ts" />
+/// <reference path="./-private/string/inflections.d.ts" />
+/// <reference path="./-private/string/inflect.d.ts" />
+/// <reference path="./-private/string/transform.d.ts" />
+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 PolicyConfig = {
+      apiCacheSoftExpires: number;
+      apiCacheHardExpires: number;
+  };
+  /**
+   * A basic CachePolicy that can be added to the Store service.
+   *
+   * Determines staleness based on time since the request was last received from the API
+   * using the `date` header.
+   *
+   * 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 { CachePolicy } from '@ember-data/request-utils';
+   * import DataStore from '@ember-data/store';
+   *
+   * // ...
+   *
+   * export class Store extends DataStore {
+   *   constructor(args) {
+   *     super(args);
+   *     this.lifetimes = new CachePolicy({ apiCacheSoftExpires: 30_000, apiCacheHardExpires: 60_000 });
+   *   }
+   * }
+   * ```
+   *
+   * @class CachePolicy
+   * @public
+   * @module @ember-data/request-utils
+   */
+  export class CachePolicy {
+      config: PolicyConfig;
+      _stores: WeakMap<Store, {
+          invalidated: Set<string>;
+          types: Map<string, Set<string>>;
+      }>;
+      _getStore(store: Store): {
+          invalidated: Set<string>;
+          types: Map<string, Set<string>>;
+      };
+      constructor(config: PolicyConfig);
+      /**
+       * Invalidate a request by its identifier for a given store instance.
+       *
+       * While the store argument may seem redundant, the CachePolicy
+       * is designed to be shared across multiple stores / forks
+       * of the store.
+       *
+       * ```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 CachePolicy
+       * is designed to be shared across multiple stores / forks
+       * of the store.
+       *
+       * This invalidation is done automatically when using this service
+       * for both the CacheHandler and the LegacyNetworkHandler.
+       *
+       * ```ts
+       * store.lifetimes.invalidateRequestsForType(store, 'person');
+       * ```
+       *
+       * @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 class LifetimesService extends CachePolicy {
+      constructor(config: PolicyConfig);
+  }
+  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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"}

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

@@ -0,0 +1,5 @@
+declare module '@ember-data/request-utils/string' {
+  export { pluralize, singularize, singular, plural, loadIrregular, loadUncountable, irregular, uncountable, resetToDefaults, clear, clearRules, } from '@ember-data/request-utils/-private/string/inflect';
+  export { dasherize, camelize, capitalize, underscore, setMaxLRUCacheSize } from '@ember-data/request-utils/-private/string/transform';
+}
+//# sourceMappingURL=string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,EACX,eAAe,EACf,KAAK,EACL,UAAU,GACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}