@ember-data/store 5.4.0-alpha.31 → 5.4.0-alpha.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ember-data/store",
-  "version": "5.4.0-alpha.31",
+  "version": "5.4.0-alpha.33",
   "description": "The core of EmberData. Provides the Store service which coordinates the cache with the network and presentation layers.",
   "keywords": [
     "ember-addon"
@@ -22,7 +22,7 @@
     "ember-data-logo-light.svg"
   ],
   "dependencies": {
-    "@ember-data/private-build-infra": "5.4.0-alpha.31",
+    "@ember-data/private-build-infra": "5.4.0-alpha.33",
     "@embroider/macros": "^1.13.5",
     "ember-cli-babel": "^8.2.0",
     "pnpm-sync-dependencies-meta-injected": "0.0.10"
@@ -45,10 +45,10 @@
     }
   },
   "peerDependencies": {
-    "@ember-data/request": "5.4.0-alpha.31",
-    "@ember-data/tracking": "5.4.0-alpha.31",
+    "@ember-data/request": "5.4.0-alpha.33",
+    "@ember-data/tracking": "5.4.0-alpha.33",
     "@ember/string": "^3.1.1",
-    "@warp-drive/core-types": "0.0.0-alpha.17"
+    "@warp-drive/core-types": "0.0.0-alpha.19"
   },
   "devDependencies": {
     "@babel/cli": "^7.23.9",
@@ -61,15 +61,15 @@
     "@babel/preset-env": "^7.23.9",
     "@babel/preset-typescript": "^7.23.3",
     "@babel/runtime": "^7.23.9",
-    "@ember-data/request": "5.4.0-alpha.31",
-    "@ember-data/tracking": "5.4.0-alpha.31",
+    "@ember-data/request": "5.4.0-alpha.33",
+    "@ember-data/tracking": "5.4.0-alpha.33",
     "@ember/string": "^3.1.1",
     "@embroider/addon-dev": "^4.1.2",
     "@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.17",
-    "@warp-drive/internal-config": "5.4.0-alpha.31",
+    "@warp-drive/core-types": "0.0.0-alpha.19",
+    "@warp-drive/internal-config": "5.4.0-alpha.33",
     "ember-source": "~5.6.0",
     "rollup": "^4.9.6",
     "typescript": "^5.3.3",

package/unstable-preview-types/-private/cache-handler.d.ts

@@ -1,99 +1,101 @@
-import type { Handler } from '@ember-data/request/-private/types';
-import type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';
-import type { ImmutableRequestInfo, RequestContext, ResponseInfo } from '@warp-drive/core-types/request';
-import { EnableHydration } from '@warp-drive/core-types/request';
-import type { ResourceIdentifierObject } from '@warp-drive/core-types/spec/raw';
-import type Store from './store-service';
-/**
- * A service which an application may provide to the store via
- * the store's `lifetimes` property to configure the behavior
- * of the CacheHandler.
- *
- * The default behavior for request lifetimes is to never expire
- * unless manually refreshed via `cacheOptions.reload` or `cacheOptions.backgroundReload`.
- *
- * Implementing this service allows you to programatically define
- * when a request should be considered expired.
- *
- * @class <Interface> LifetimesService
- * @public
- */
-export interface LifetimesService {
-    /**
-     * Invoked to determine if the request may be fulfilled from cache
-     * if possible.
-     *
-     * Note, this is only invoked 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 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;
-    /**
-     * Invoked when a request will be sent to the configured request handlers.
-     * This is invoked for both foreground and background requests.
-     *
-     * Note, this is invoked regardless of whether the request has a cache-key.
-     *
-     * @method willRequest [Optional]
-     * @public
-     * @param {ImmutableRequestInfo} request
-     * @param {StableDocumentIdentifier | null} identifier
-     * @param {Store} store
-     * @return {void}
-     */
-    willRequest?(request: ImmutableRequestInfo, identifier: StableDocumentIdentifier | null, store: Store): void;
-    /**
-     * Invoked when a request has been fulfilled from the configured request handlers.
-     * This is invoked for both foreground and background requests once the cache has
-     * been updated.
-     *
-     * Note, this is invoked regardless of whether the request has a cache-key.
-     *
-     * @method didRequest [Optional]
-     * @public
-     * @param {ImmutableRequestInfo} request
-     * @param {ImmutableResponse} response
-     * @param {StableDocumentIdentifier | null} identifier
-     * @param {Store} store
-     * @return {void}
-     */
-    didRequest?(request: ImmutableRequestInfo, response: Response | ResponseInfo | null, identifier: StableDocumentIdentifier | null, store: Store): void;
-}
-export type StoreRequestInfo = ImmutableRequestInfo;
-export type LooseStoreRequestInfo = Omit<StoreRequestInfo, 'records' | 'headers'> & {
-    records?: ResourceIdentifierObject[];
-    headers?: Headers;
-};
-export type StoreRequestInput = StoreRequestInfo | LooseStoreRequestInfo;
-export interface StoreRequestContext extends RequestContext {
-    request: StoreRequestInfo & {
-        store: Store;
-        [EnableHydration]?: boolean;
-    };
-}
-export declare const CacheHandler: Handler;
-//# sourceMappingURL=cache-handler.d.ts.map
+declare module '@ember-data/store/-private/cache-handler' {
+  import type { Handler } from '@ember-data/request/-private/types';
+  import type { StableDocumentIdentifier } from '@warp-drive/core-types/identifier';
+  import type { ImmutableRequestInfo, RequestContext, ResponseInfo } from '@warp-drive/core-types/request';
+  import { EnableHydration } from '@warp-drive/core-types/request';
+  import type { ResourceIdentifierObject } from '@warp-drive/core-types/spec/raw';
+  import type Store from '@ember-data/store/-private/store-service';
+  /**
+   * A service which an application may provide to the store via
+   * the store's `lifetimes` property to configure the behavior
+   * of the CacheHandler.
+   *
+   * The default behavior for request lifetimes is to never expire
+   * unless manually refreshed via `cacheOptions.reload` or `cacheOptions.backgroundReload`.
+   *
+   * Implementing this service allows you to programatically define
+   * when a request should be considered expired.
+   *
+   * @class <Interface> LifetimesService
+   * @public
+   */
+  export interface LifetimesService {
+      /**
+       * Invoked to determine if the request may be fulfilled from cache
+       * if possible.
+       *
+       * Note, this is only invoked 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 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;
+      /**
+       * Invoked when a request will be sent to the configured request handlers.
+       * This is invoked for both foreground and background requests.
+       *
+       * Note, this is invoked regardless of whether the request has a cache-key.
+       *
+       * @method willRequest [Optional]
+       * @public
+       * @param {ImmutableRequestInfo} request
+       * @param {StableDocumentIdentifier | null} identifier
+       * @param {Store} store
+       * @return {void}
+       */
+      willRequest?(request: ImmutableRequestInfo, identifier: StableDocumentIdentifier | null, store: Store): void;
+      /**
+       * Invoked when a request has been fulfilled from the configured request handlers.
+       * This is invoked for both foreground and background requests once the cache has
+       * been updated.
+       *
+       * Note, this is invoked regardless of whether the request has a cache-key.
+       *
+       * @method didRequest [Optional]
+       * @public
+       * @param {ImmutableRequestInfo} request
+       * @param {ImmutableResponse} response
+       * @param {StableDocumentIdentifier | null} identifier
+       * @param {Store} store
+       * @return {void}
+       */
+      didRequest?(request: ImmutableRequestInfo, response: Response | ResponseInfo | null, identifier: StableDocumentIdentifier | null, store: Store): void;
+  }
+  export type StoreRequestInfo = ImmutableRequestInfo;
+  export type LooseStoreRequestInfo = Omit<StoreRequestInfo, 'records' | 'headers'> & {
+      records?: ResourceIdentifierObject[];
+      headers?: Headers;
+  };
+  export type StoreRequestInput = StoreRequestInfo | LooseStoreRequestInfo;
+  export interface StoreRequestContext extends RequestContext {
+      request: StoreRequestInfo & {
+          store: Store;
+          [EnableHydration]?: boolean;
+      };
+  }
+  export declare const CacheHandler: Handler;
+  //# sourceMappingURL=cache-handler.d.ts.map
+}

package/unstable-preview-types/-private/caches/cache-utils.d.ts

@@ -1,9 +1,11 @@
-import type { StableRecordIdentifier } from '@warp-drive/core-types/identifier';
-import type { Cache } from '../../-types/q/cache';
-import type { OpaqueRecordInstance } from '../../-types/q/record-instance';
-export declare const CacheForIdentifierCache: Map<unknown, Cache>;
-export declare function setCacheFor(identifier: StableRecordIdentifier | OpaqueRecordInstance, cache: Cache): void;
-export declare function removeRecordDataFor(identifier: StableRecordIdentifier | OpaqueRecordInstance): void;
-export default function peekCache(instance: StableRecordIdentifier): Cache | null;
-export default function peekCache(instance: OpaqueRecordInstance): Cache;
-//# sourceMappingURL=cache-utils.d.ts.map
+declare module '@ember-data/store/-private/caches/cache-utils' {
+  import type { StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+  import type { Cache } from '@ember-data/store/-types/q/cache';
+  import type { OpaqueRecordInstance } from '@ember-data/store/-types/q/record-instance';
+  export declare const CacheForIdentifierCache: Map<unknown, Cache>;
+  export declare function setCacheFor(identifier: StableRecordIdentifier | OpaqueRecordInstance, cache: Cache): void;
+  export declare function removeRecordDataFor(identifier: StableRecordIdentifier | OpaqueRecordInstance): void;
+  export default function peekCache(instance: StableRecordIdentifier): Cache | null;
+  export default function peekCache(instance: OpaqueRecordInstance): Cache;
+  //# sourceMappingURL=cache-utils.d.ts.map
+}

package/unstable-preview-types/-private/caches/identifier-cache.d.ts

@@ -1,180 +1,182 @@
-import { type Identifier, type RecordIdentifier, type StableDocumentIdentifier, type StableRecordIdentifier } from '@warp-drive/core-types/identifier';
-import type { ImmutableRequestInfo } from '@warp-drive/core-types/request';
-import type { ResourceIdentifierObject } from '@warp-drive/core-types/spec/raw';
-import type { ForgetMethod, GenerationMethod, ResetMethod, UpdateMethod } from '../../-types/q/identifier';
-export declare function isStableIdentifier(identifier: unknown): identifier is StableRecordIdentifier;
-export declare function isDocumentIdentifier(identifier: unknown): identifier is StableDocumentIdentifier;
-interface KeyOptions {
-    lid: IdentifierMap;
-    id: IdentifierMap;
-}
-type TypeMap = {
-    [key: string]: KeyOptions;
-};
-type IdentifierMap = Map<string, StableRecordIdentifier>;
-type KeyInfo = {
-    id: string | null;
-    type: string;
-};
-type StableCache = {
-    resources: IdentifierMap;
-    documents: Map<string, StableDocumentIdentifier>;
-    resourcesByType: TypeMap;
-    polymorphicLidBackMap: Map<string, string[]>;
-};
-export type KeyInfoMethod = (resource: unknown, known: StableRecordIdentifier | null) => KeyInfo;
-export type MergeMethod = (targetIdentifier: StableRecordIdentifier, matchedIdentifier: StableRecordIdentifier, resourceData: unknown) => StableRecordIdentifier;
-export declare function setIdentifierGenerationMethod(method: GenerationMethod | null): void;
-export declare function setIdentifierUpdateMethod(method: UpdateMethod | null): void;
-export declare function setIdentifierForgetMethod(method: ForgetMethod | null): void;
-export declare function setIdentifierResetMethod(method: ResetMethod | null): void;
-export declare function setKeyInfoForResource(method: KeyInfoMethod | null): void;
-/**
- * Each instance of {Store} receives a unique instance of a IdentifierCache.
- *
- * This cache is responsible for assigning or retrieving the unique identify
- * for arbitrary resource data encountered by the store. Data representing
- * a unique resource or record should always be represented by the same
- * identifier.
- *
- * It can be configured by consuming applications.
- *
- * @class IdentifierCache
-   @public
- */
-export declare class IdentifierCache {
-    _cache: StableCache;
-    _generate: GenerationMethod;
-    _update: UpdateMethod;
-    _forget: ForgetMethod;
-    _reset: ResetMethod;
-    _merge: MergeMethod;
-    _keyInfoForResource: KeyInfoMethod;
-    _isDefaultConfig: boolean;
-    _id: number;
-    constructor();
-    /**
-     * Internal hook to allow management of merge conflicts with identifiers.
-     *
-     * we allow late binding of this private internal merge so that
-     * the cache can insert itself here to handle elimination of duplicates
-     *
-     * @method __configureMerge
-     * @private
-     */
-    __configureMerge(method: MergeMethod | null): void;
-    upgradeIdentifier(resource: {
-        type: string;
-        id: string | null;
-        lid?: string;
-    }): StableRecordIdentifier;
-    /**
-     * @method _getRecordIdentifier
-     * @private
-     */
-    _getRecordIdentifier(resource: {
-        type: string;
-        id: string | null;
-        lid?: string;
-    }, shouldGenerate: 2): StableRecordIdentifier;
-    _getRecordIdentifier(resource: unknown, shouldGenerate: 1): StableRecordIdentifier;
-    _getRecordIdentifier(resource: unknown, shouldGenerate: 0): StableRecordIdentifier | undefined;
-    /**
-     * allows us to peek without generating when needed
-     * useful for the "create" case when we need to see if
-     * we are accidentally overwritting something
-     *
-     * @method peekRecordIdentifier
-     * @param resource
-     * @return {StableRecordIdentifier | undefined}
-     * @private
-     */
-    peekRecordIdentifier(resource: ResourceIdentifierObject | Identifier): StableRecordIdentifier | undefined;
-    /**
-      Returns the DocumentIdentifier for the given Request, creates one if it does not yet exist.
-      Returns `null` if the request does not have a `cacheKey` or `url`.
-  
-      @method getOrCreateDocumentIdentifier
-      @param request
-      @return {StableDocumentIdentifier | null}
-      @public
-    */
-    getOrCreateDocumentIdentifier(request: ImmutableRequestInfo): StableDocumentIdentifier | null;
-    /**
-      Returns the Identifier for the given Resource, creates one if it does not yet exist.
-  
-      Specifically this means that we:
-  
-      - validate the `id` `type` and `lid` combo against known identifiers
-      - return an object with an `lid` that is stable (repeated calls with the same
-        `id` + `type` or `lid` will return the same `lid` value)
-      - this referential stability of the object itself is guaranteed
-  
-      @method getOrCreateRecordIdentifier
-      @param resource
-      @return {StableRecordIdentifier}
-      @public
-    */
-    getOrCreateRecordIdentifier(resource: unknown): StableRecordIdentifier;
-    /**
-     Returns a new Identifier for the supplied data. Call this method to generate
-     an identifier when a new resource is being created local to the client and
-     potentially does not have an `id`.
-  
-     Delegates generation to the user supplied `GenerateMethod` if one has been provided
-     with the signature `generateMethod({ type }, 'record')`.
-  
-     @method createIdentifierForNewRecord
-     @param data
-     @return {StableRecordIdentifier}
+declare module '@ember-data/store/-private/caches/identifier-cache' {
+  import { type Identifier, type RecordIdentifier, type StableDocumentIdentifier, type StableRecordIdentifier } from '@warp-drive/core-types/identifier';
+  import type { ImmutableRequestInfo } from '@warp-drive/core-types/request';
+  import type { ResourceIdentifierObject } from '@warp-drive/core-types/spec/raw';
+  import type { ForgetMethod, GenerationMethod, ResetMethod, UpdateMethod } from '@ember-data/store/-types/q/identifier';
+  export declare function isStableIdentifier(identifier: unknown): identifier is StableRecordIdentifier;
+  export declare function isDocumentIdentifier(identifier: unknown): identifier is StableDocumentIdentifier;
+  interface KeyOptions {
+      lid: IdentifierMap;
+      id: IdentifierMap;
+  }
+  type TypeMap = {
+      [key: string]: KeyOptions;
+  };
+  type IdentifierMap = Map<string, StableRecordIdentifier>;
+  type KeyInfo = {
+      id: string | null;
+      type: string;
+  };
+  type StableCache = {
+      resources: IdentifierMap;
+      documents: Map<string, StableDocumentIdentifier>;
+      resourcesByType: TypeMap;
+      polymorphicLidBackMap: Map<string, string[]>;
+  };
+  export type KeyInfoMethod = (resource: unknown, known: StableRecordIdentifier | null) => KeyInfo;
+  export type MergeMethod = (targetIdentifier: StableRecordIdentifier, matchedIdentifier: StableRecordIdentifier, resourceData: unknown) => StableRecordIdentifier;
+  export declare function setIdentifierGenerationMethod(method: GenerationMethod | null): void;
+  export declare function setIdentifierUpdateMethod(method: UpdateMethod | null): void;
+  export declare function setIdentifierForgetMethod(method: ForgetMethod | null): void;
+  export declare function setIdentifierResetMethod(method: ResetMethod | null): void;
+  export declare function setKeyInfoForResource(method: KeyInfoMethod | null): void;
+  /**
+   * Each instance of {Store} receives a unique instance of a IdentifierCache.
+   *
+   * This cache is responsible for assigning or retrieving the unique identify
+   * for arbitrary resource data encountered by the store. Data representing
+   * a unique resource or record should always be represented by the same
+   * identifier.
+   *
+   * It can be configured by consuming applications.
+   *
+   * @class IdentifierCache
      @public
-    */
-    createIdentifierForNewRecord(data: {
-        type: string;
-        id?: string | null;
-    }): StableRecordIdentifier;
-    /**
-     Provides the opportunity to update secondary lookup tables for existing identifiers
-     Called after an identifier created with `createIdentifierForNewRecord` has been
-     committed.
-  
-     Assigned `id` to an `Identifier` if `id` has not previously existed; however,
-     attempting to change the `id` or calling update without providing an `id` when
-     one is missing will throw an error.
-  
-      - sets `id` (if `id` was previously `null`)
-      - `lid` and `type` MUST NOT be altered post creation
-  
-      If a merge occurs, it is possible the returned identifier does not match the originally
-      provided identifier. In this case the abandoned identifier will go through the usual
-      `forgetRecordIdentifier` codepaths.
-  
-      @method updateRecordIdentifier
-      @param identifierObject
-      @param data
-      @return {StableRecordIdentifier}
-      @public
-    */
-    updateRecordIdentifier(identifierObject: RecordIdentifier, data: unknown): StableRecordIdentifier;
-    /**
-     * @method _mergeRecordIdentifiers
-     * @private
-     */
-    _mergeRecordIdentifiers(keyInfo: KeyInfo, identifier: StableRecordIdentifier, existingIdentifier: StableRecordIdentifier, data: unknown): StableRecordIdentifier;
-    /**
-     Provides the opportunity to eliminate an identifier from secondary lookup tables
-     as well as eliminates it from ember-data's own lookup tables and book keeping.
-  
-     Useful when a record has been deleted and the deletion has been persisted and
-     we do not care about the record anymore. Especially useful when an `id` of a
-     deleted record might be reused later for a new record.
-  
-     @method forgetRecordIdentifier
-     @param identifierObject
-     @public
-    */
-    forgetRecordIdentifier(identifierObject: RecordIdentifier): void;
-    destroy(): void;
-}
-export {};
-//# sourceMappingURL=identifier-cache.d.ts.map
+   */
+  export declare class IdentifierCache {
+      _cache: StableCache;
+      _generate: GenerationMethod;
+      _update: UpdateMethod;
+      _forget: ForgetMethod;
+      _reset: ResetMethod;
+      _merge: MergeMethod;
+      _keyInfoForResource: KeyInfoMethod;
+      _isDefaultConfig: boolean;
+      _id: number;
+      constructor();
+      /**
+       * Internal hook to allow management of merge conflicts with identifiers.
+       *
+       * we allow late binding of this private internal merge so that
+       * the cache can insert itself here to handle elimination of duplicates
+       *
+       * @method __configureMerge
+       * @private
+       */
+      __configureMerge(method: MergeMethod | null): void;
+      upgradeIdentifier(resource: {
+          type: string;
+          id: string | null;
+          lid?: string;
+      }): StableRecordIdentifier;
+      /**
+       * @method _getRecordIdentifier
+       * @private
+       */
+      _getRecordIdentifier(resource: {
+          type: string;
+          id: string | null;
+          lid?: string;
+      }, shouldGenerate: 2): StableRecordIdentifier;
+      _getRecordIdentifier(resource: unknown, shouldGenerate: 1): StableRecordIdentifier;
+      _getRecordIdentifier(resource: unknown, shouldGenerate: 0): StableRecordIdentifier | undefined;
+      /**
+       * allows us to peek without generating when needed
+       * useful for the "create" case when we need to see if
+       * we are accidentally overwritting something
+       *
+       * @method peekRecordIdentifier
+       * @param resource
+       * @return {StableRecordIdentifier | undefined}
+       * @private
+       */
+      peekRecordIdentifier(resource: ResourceIdentifierObject | Identifier): StableRecordIdentifier | undefined;
+      /**
+        Returns the DocumentIdentifier for the given Request, creates one if it does not yet exist.
+        Returns `null` if the request does not have a `cacheKey` or `url`.
+    
+        @method getOrCreateDocumentIdentifier
+        @param request
+        @return {StableDocumentIdentifier | null}
+        @public
+      */
+      getOrCreateDocumentIdentifier(request: ImmutableRequestInfo): StableDocumentIdentifier | null;
+      /**
+        Returns the Identifier for the given Resource, creates one if it does not yet exist.
+    
+        Specifically this means that we:
+    
+        - validate the `id` `type` and `lid` combo against known identifiers
+        - return an object with an `lid` that is stable (repeated calls with the same
+          `id` + `type` or `lid` will return the same `lid` value)
+        - this referential stability of the object itself is guaranteed
+    
+        @method getOrCreateRecordIdentifier
+        @param resource
+        @return {StableRecordIdentifier}
+        @public
+      */
+      getOrCreateRecordIdentifier(resource: unknown): StableRecordIdentifier;
+      /**
+       Returns a new Identifier for the supplied data. Call this method to generate
+       an identifier when a new resource is being created local to the client and
+       potentially does not have an `id`.
+    
+       Delegates generation to the user supplied `GenerateMethod` if one has been provided
+       with the signature `generateMethod({ type }, 'record')`.
+    
+       @method createIdentifierForNewRecord
+       @param data
+       @return {StableRecordIdentifier}
+       @public
+      */
+      createIdentifierForNewRecord(data: {
+          type: string;
+          id?: string | null;
+      }): StableRecordIdentifier;
+      /**
+       Provides the opportunity to update secondary lookup tables for existing identifiers
+       Called after an identifier created with `createIdentifierForNewRecord` has been
+       committed.
+    
+       Assigned `id` to an `Identifier` if `id` has not previously existed; however,
+       attempting to change the `id` or calling update without providing an `id` when
+       one is missing will throw an error.
+    
+        - sets `id` (if `id` was previously `null`)
+        - `lid` and `type` MUST NOT be altered post creation
+    
+        If a merge occurs, it is possible the returned identifier does not match the originally
+        provided identifier. In this case the abandoned identifier will go through the usual
+        `forgetRecordIdentifier` codepaths.
+    
+        @method updateRecordIdentifier
+        @param identifierObject
+        @param data
+        @return {StableRecordIdentifier}
+        @public
+      */
+      updateRecordIdentifier(identifierObject: RecordIdentifier, data: unknown): StableRecordIdentifier;
+      /**
+       * @method _mergeRecordIdentifiers
+       * @private
+       */
+      _mergeRecordIdentifiers(keyInfo: KeyInfo, identifier: StableRecordIdentifier, existingIdentifier: StableRecordIdentifier, data: unknown): StableRecordIdentifier;
+      /**
+       Provides the opportunity to eliminate an identifier from secondary lookup tables
+       as well as eliminates it from ember-data's own lookup tables and book keeping.
+    
+       Useful when a record has been deleted and the deletion has been persisted and
+       we do not care about the record anymore. Especially useful when an `id` of a
+       deleted record might be reused later for a new record.
+    
+       @method forgetRecordIdentifier
+       @param identifierObject
+       @public
+      */
+      forgetRecordIdentifier(identifierObject: RecordIdentifier): void;
+      destroy(): void;
+  }
+  export {};
+  //# sourceMappingURL=identifier-cache.d.ts.map
+}