@warp-drive/core 5.10.0-alpha.0 → 5.10.0-alpha.10

package/dist/{internal-DtWOpxrR.d.ts → internal-9XuWZdDv.d.ts}

@@ -3,7 +3,7 @@ import { t as QueryParamsSerializationOptions } from "./params-DrEx3bf8.js";
 import { a as Type, n as RequestSignature } from "./symbols-DjRDCeX0.js";
 import { c as TypedRecordInstance, i as OpaqueRecordInstance$1, o as TypeFromInstance, s as TypeFromInstanceOrString } from "./record-D3QQcaIR.js";
 import { i as Value, n as ObjectValue } from "./raw-D5hnjiq7.js";
-import { d as Meta, g as ResourceIdentifierObject, i as ExistingResourceIdentifierObject, m as PaginationLinks, r as EmptyResourceDocument, s as JsonApiDocument, t as CollectionResourceDocument, u as Links, y as SingleResourceDocument } from "./json-api-raw-C5APJHHB.js";
+import { a as ExistingResourceObject, d as Meta, g as ResourceIdentifierObject, i as ExistingResourceIdentifierObject, m as PaginationLinks, r as EmptyResourceDocument, s as JsonApiDocument, t as CollectionResourceDocument, u as Links, y as SingleResourceDocument } from "./json-api-raw-C5APJHHB.js";
 import { A as ResourceField, C as ObjectField, F as Trait, M as Schema, N as SchemaArrayField, O as PolarisResourceSchema, P as SchemaObjectField, T as ObjectSchema, a as DerivedField, b as LinksModeHasManyField, c as HashField, d as LegacyAttributeField, f as LegacyBelongsToField, g as LegacyRelationshipField, i as CollectionField, j as ResourceSchema, l as IdentityField, m as LegacyHasManyField, o as FieldSchema, r as CacheableFieldSchema, s as GenericField, t as ArrayField } from "./fields-FM7peCiM.js";
 import { n as HashFn, r as Transformation$1, t as Derivation } from "./concepts-DFldVwEM.js";
 import { n as WithPartial } from "./utils-BtURiy8l.js";
@@ -12,8 +12,8 @@ import { t as Change } from "./change-C7kqv2kW.js";
 import { n as Mutation } from "./mutations-CqtoGB4t.js";
 import { r as ResourceRelationship, t as CollectionRelationship } from "./relationship-CmHzMPKf.js";
 import { i as MergeOperation, o as Operation$1 } from "./operations-D1qA6r0_.js";
-import { t as ApiError } from "./error-50OSEhsF.js";
-import { o as SingleResourceDataDocument, r as ResourceDocument, t as CollectionResourceDataDocument } from "./document-BEn91SwT.js";
+import { t as ApiError } from "./error-0uD6GkNX.js";
+import { o as SingleResourceDataDocument, r as ResourceDocument, t as CollectionResourceDataDocument } from "./document-Ca4ZZBd9.js";
 import { i as RemoteRelationshipOperation, n as LocalRelationshipOperation, t as DeleteRecordOperation } from "./graph-DLqYXP2z.js";
 import { i as SignalRef, t as ARRAY_SIGNAL } from "./configure-B_F639tN.js";
 //#region src/request/-private/manager.d.ts
@@ -1295,489 +1295,6 @@ type KeyInfo = {
 };
 type KeyInfoMethod = (resource: unknown, known: ResourceKey | null) => KeyInfo;
 //#endregion
-//#region src/store/-private/managers/cache-key-manager.d.ts
-type TypeFromIdentifier<T> = T extends {
-  type: infer U;
-} ? U : string;
-type NarrowIdentifierIfPossible<T> = T extends ExistingResourceIdentifierObject ? PersistedResourceKey<TypeFromIdentifier<T>> : ResourceKey;
-/**
- * Type-guard that returns `true` if the given value is a stable {@link ResourceKey}
- * (as opposed to a {@link RequestKey} or arbitrary, not-yet-stabilized resource data).
- */
-declare function isResourceKey(identifier: unknown): identifier is ResourceKey;
-/**
- * Type-guard that returns `true` if the given value is a stable {@link RequestKey}
- * (as opposed to a {@link ResourceKey} or arbitrary, not-yet-stabilized data).
- */
-declare function isRequestKey(identifier: unknown): identifier is RequestKey;
-interface KeyOptions {
-  lid: IdentifierMap;
-  id: IdentifierMap;
-}
-type TypeMap = {
-  [key: string]: KeyOptions;
-};
-type IdentifierMap = Map<string, ResourceKey>;
-type StableCache = {
-  resources: IdentifierMap;
-  documents: Map<string, RequestKey>;
-  resourcesByType: TypeMap;
-  polymorphicLidBackMap: Map<string, string[]>;
-};
-type MergeMethod = (targetIdentifier: ResourceKey, matchedIdentifier: ResourceKey, resourceData: unknown) => ResourceKey;
-/**
-Configures how unique identifier lid strings are generated by @ember-data/store.
-
-This configuration MUST occur prior to the store instance being created.
-
-Takes a method which can expect to receive various data as its first argument
-and the name of a bucket as its second argument.
-
-Currently there are two buckets, 'record' and 'document'.
-
-### Resource (`Record`) Identity
-
-If the bucket is `record` the method must return a unique (to at-least
-the given bucket) string identifier for the given data as a string to be
-used as the `lid` of an `Identifier` token.
-
-This method will only be called by either `getOrCreateRecordIdentifier` or
-`createIdentifierForNewRecord` when an identifier for the supplied data
-is not already known via `lid` or `type + id` combo and one needs to be
-generated or retrieved from a proprietary cache.
-
-`data` will be the same data argument provided to `getOrCreateRecordIdentifier`
-and in the `createIdentifierForNewRecord` case will be an object with
-only `type` as a key.
-
-```ts
-import { setIdentifierGenerationMethod } from '@warp-drive/core';
-
-export function initialize(applicationInstance) {
-// note how `count` here is now scoped to the application instance
-// for our generation method by being inside the closure provided
-// by the initialize function
-let count = 0;
-
-setIdentifierGenerationMethod((resource, bucket) => {
-return resource.lid || `my-key-${count++}`;
-});
-}
-
-export default {
-name: 'configure-ember-data-identifiers',
-initialize
-};
-```
-
-### Document Identity
-
-If the bucket is `document` the method will receive the associated
-immutable `request` passed to `store.request` as its first argument
-and should return a unique string for the given request if the document
-should be cached, and `null` if it should not be cached.
-
-Note, the request result will still be passed to the cache via `Cache.put`,
-but caches should take this as a signal that the document should not itself
-be cached, while its contents may still be used to update other cache state.
-
-The presence of `cacheOptions.key` on the request will take precedence
-for the document cache key, and this method will not be called if it is
-present.
-
-The default method implementation for this bucket is to return `null`
-for all requests whose method is not `GET`, and to return the `url` for
-those where it is.
-
-This means that queries via `POST` MUST provide `cacheOptions.key` or
-implement this hook.
-
-⚠️ Caution: Requests that do not have a `method` assigned are assumed to be `GET`
-
-@public
-*/
-declare function setIdentifierGenerationMethod(method: GenerationMethod | null): void;
-/**
-Configure a callback for when the identifier cache encounters new resource
-data for an existing resource.
-
-This configuration MUST occur prior to the store instance being created.
-
-```js
-import { setIdentifierUpdateMethod } from '@warp-drive/core';
-```
-
-Takes a method which can expect to receive an existing `Identifier` alongside
-some new data to consider as a second argument. This is an opportunity
-for secondary lookup tables and caches associated with the identifier
-to be amended.
-
-This method is called everytime `updateRecordIdentifier` is called and
-with the same arguments. It provides the opportunity to update secondary
-lookup tables for existing identifiers.
-
-It will always be called after an identifier created with `createIdentifierForNewRecord`
-has been committed, or after an update to the `record` a `RecordIdentifier`
-is assigned to has been committed. Committed here meaning that the server
-has acknowledged the update (for instance after a call to `.save()`)
-
-If `id` has not previously existed, it will be assigned to the `Identifier`
-prior to this `UpdateMethod` being called; however, calls to the parent method
-`updateRecordIdentifier` that attempt to change the `id` or calling update
-without providing an `id` when one is missing will throw an error.
-
-@public
-*/
-declare function setIdentifierUpdateMethod(method: UpdateMethod | null): void;
-/**
-Configure a callback for when the identifier cache is going to release an identifier.
-
-This configuration MUST occur prior to the store instance being created.
-
-```js
-import { setIdentifierForgetMethod } from '@warp-drive/core';
-```
-
-Takes method which can expect to receive an existing `Identifier` that should be eliminated
-from any secondary lookup tables or caches that the user has populated for it.
-
-@public
-*/
-declare function setIdentifierForgetMethod(method: ForgetMethod | null): void;
-/**
-Configure a callback for when the identifier cache is being torn down.
-
-This configuration MUST occur prior to the store instance being created.
-
-```js
-import { setIdentifierResetMethod } from '@warp-drive/core';
-```
-
-Takes a method which can expect to be called when the parent application is destroyed.
-
-If you have properly used a WeakMap to encapsulate the state of your customization
-to the application instance, you may not need to implement the `resetMethod`.
-
-@public
-*/
-declare function setIdentifierResetMethod(method: ResetMethod | null): void;
-/**
-Configure a callback for when the identifier cache is generating a new
-ResourceKey for a resource.
-
-This method controls the `type` and `id` that will be assigned to the
-`ResourceKey` that is created.
-
-This configuration MUST occur prior to the store instance being created.
-
-```js
-import { setKeyInfoForResource } from '@warp-drive/core';
-```
-
-@public
-*/
-declare function setKeyInfoForResource(method: KeyInfoMethod | null): void;
-/**
- * Each instance of {@link Store} receives a unique instance of a CacheKeyManager.
- *
- * 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.
- *
- * @hideconstructor
- * @public
- */
-declare class CacheKeyManager {
-  constructor();
-  /**
-   * allows us to peek without generating when needed
-   * useful for the "create" case when we need to see if
-   * we are accidentally overwritting something
-   *
-   * @private
-   */
-  peekResourceKey(resource: ResourceIdentifierObject): ResourceKey | undefined;
-  /**
-   * Peeks the {@link RequestKey} for the given {@link RequestInfo}, but will not
-   * create one if none has been previously generated.
-   *
-   * @public
-   */
-  peekRequestKey(request: RequestInfo): RequestKey | null;
-  /**
-   * Returns the {@link RequestKey} for the given {@link RequestInfo} if the request is
-   * considered cacheable. For cacheable requests, this method will create
-   * a RequestKey if none is found.
-   *
-   * A `null` response indicates the request cannot/will not be cached,
-   * generally this means either
-   *
-   * - {@link RequestInfo.cacheOptions.key} is not present on the `RequestInfo`
-   * - the request's method is `GET` but it has no `url`
-   *
-   * Generally you should not seek to cache requests that are not idempotent
-   * or have side effects, such as mutations that create, update or delete
-   * a resource.
-   *
-   * @public
-   */
-  getOrCreateDocumentIdentifier(request: RequestInfo): RequestKey | null;
-  /**
-	Returns the {@link ResourceKey} 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
-	
-	@public
-	*/
-  getOrCreateRecordIdentifier<T>(resource: T): NarrowIdentifierIfPossible<T>;
-  /**
-	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')`.
-	
-	@public
-	*/
-  createIdentifierForNewRecord(data: {
-    type: string;
-    id?: string | null;
-    lid?: string;
-  }): ResourceKey;
-  /**
-	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.
-	
-	@public
-	*/
-  updateRecordIdentifier(identifierObject: ResourceKey, data: unknown): ResourceKey;
-  /**
-	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.
-	
-	@public
-	*/
-  forgetRecordIdentifier(identifierObject: ResourceKey): void;
-}
-/**
- * This type exists for internal use only for
- * where intimate contracts still exist either for
- * the Test Suite or for Legacy code.
- *
- * @private
- */
-interface PrivateCacheKeyManager extends CacheKeyManager {
-  _cache: StableCache;
-  /**
-   * 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
-   */
-  __configureMerge(method: MergeMethod | null): void;
-  _mergeRecordIdentifiers(keyInfo: KeyInfo, identifier: ResourceKey, existingIdentifier: ResourceKey, data: unknown): ResourceKey;
-  destroy(): void;
-}
-//#endregion
-//#region src/store/-private/managers/notification-manager.d.ts
-type UnsubscribeToken$1 = object;
-/**
- * The kinds of change notifications the {@link NotificationManager} can emit for a resource.
- */
-type CacheOperation$1 = "added" | "removed" | "updated" | "state";
-/**
- * The kinds of change notifications the {@link NotificationManager} can emit for a request document.
- */
-type DocumentCacheOperation$1 = "invalidated" | "added" | "removed" | "updated" | "state";
-/**
- * The full set of notification kinds the {@link NotificationManager} can emit for a resource,
- * including both {@link CacheOperation}s and finer-grained field-level change notifications.
- */
-type NotificationType = "attributes" | "relationships" | "identity" | "errors" | "meta" | CacheOperation$1;
-/**
- * The shape accepted by {@link NotificationManager.notify} and
- * {@link CacheCapabilitiesManager.notifyChange} for delivering many keys for
- * the `'attributes'` or `'relationships'` namespaces in a single call
- * instead of once per key.
- *
- * @since 5.9.0
- * @public
- */
-type NotifyKeys = Set<string>;
-/**
- * A change to a resource's `attributes` or `relationships` can be relevant to
- * a "local" view of the resource (its mutable/editable state), a "remote" view
- * (its last-known-persisted state), or both.
- *
- * Each view subscribes to its own channel and, when notified, re-pulls its own
- * projection of the data: a remote-only reader (e.g. PolarisMode's default
- * immutable record) subscribes `'remote'` and re-reads remote state; an
- * editable/reconciled reader (a legacy record, or an editable checkout)
- * subscribes `'local'` (the same as omitting the channel) and re-reads local
- * state. A notifier that knows which projection changed tags the notification
- * with that channel; each tag is delivered only to that channel's subscribers.
- * A change affecting both projections is either notified unscoped or once per
- * channel. An unscoped notify cannot guarantee which view changed, so it
- * reaches every subscriber -- this keeps every pre-channel `notify` callsite
- * (and any custom cache that doesn't know about channels) fully compatible.
- *
- * The full delivery matrix:
- *
- * | notify ↓ subscribe → | `'local'` | `'remote'` | omitted (= `'local'`) |
- * | -------------------- | --------- | ---------- | --------------------- |
- * | `'local'`            | ✅        | ❌         | ✅                    |
- * | `'remote'`           | ❌        | ✅         | ❌                    |
- * | omitted              | ✅        | ✅         | ✅                    |
- *
- * Channel only applies to the `'attributes'` and `'relationships'`
- * notification types. All other types (`'errors'`,
- * `'identity'`, `'state'`, and the various `CacheOperation`/
- * `DocumentCacheOperation` values) are never filtered by channel since they
- * have no local/remote duality.
- *
- * @public
- */
-type NotificationChannel = "local" | "remote";
-interface NotificationCallback$1 {
-  (cacheKey: ResourceKey, notificationType: "attributes" | "relationships", key?: string): void;
-  (cacheKey: ResourceKey, notificationType: "errors" | "meta" | "identity" | "state"): void;
-  (cacheKey: ResourceKey, notificationType: CacheOperation$1): void;
-}
-interface ResourceOperationCallback$1 {
-  (cacheKey: ResourceKey, notificationType: CacheOperation$1): void;
-}
-interface DocumentOperationCallback$1 {
-  (cacheKey: RequestKey, notificationType: DocumentCacheOperation$1): void;
-}
-/**
- * The NotificationManager provides the ability to subscribe to
- * changes to Cache state.
- *
- * This Feature is what allows WarpDrive to create subscriptions that
- * work with any framework or change-notification system.
- *
- * @hideconstructor
- * @public
- */
-declare class NotificationManager$1 {
-  constructor(store: Store$1);
-  /**
-   * Subscribe to changes for a given ResourceKey, RequestKey, or addition/removal of any resource
-   * or document.
-   *
-   * ```ts
-   * export type CacheOperation = 'added' | 'removed' | 'updated' | 'state';
-   *
-   * export interface NotificationCallback {
-   *   (cacheKey: ResourceKey, notificationType: 'attributes' | 'relationships', key?: string): void;
-   *   (cacheKey: ResourceKey, notificationType: 'errors' | 'meta' | 'identity' | 'state'): void;
-   *   (cacheKey: ResourceKey, notificationType: NotificationType, key?: string): void;
-   * }
-   * export interface ResourceOperationCallback {
-   *   // resource updates
-   *   (cacheKey: ResourceKey, notificationType: CacheOperation): void;
-   * }
-   * export interface DocumentOperationCallback {
-   *   // document updates
-   *   (cacheKey: RequestKey, notificationType: CacheOperation): void;
-   * }
-   * ```
-   *
-   * A `channel` may be provided when subscribing to a `ResourceKey`. Its
-   * effect is that the subscription skips `'attributes'`/`'relationships'`
-   * notifications explicitly tagged with the *other* channel; unscoped
-   * notifications, and notifications for all other notification types, always
-   * reach the subscriber. Subscribing `'local'` and omitting the channel are
-   * the same thing. See {@link NotificationChannel}.
-   *
-   * | notify ↓ subscribe → | `'local'` | `'remote'` | omitted (= `'local'`) |
-   * | -------------------- | --------- | ---------- | --------------------- |
-   * | `'local'`            | ✅        | ❌         | ✅                    |
-   * | `'remote'`           | ❌        | ✅         | ❌                    |
-   * | omitted              | ✅        | ✅         | ✅                    |
-   *
-   * @public
-   * @return an opaque token to be used with unsubscribe
-   */
-  subscribe(cacheKey: ResourceKey, callback: NotificationCallback$1, channel?: NotificationChannel): UnsubscribeToken$1;
-  subscribe(cacheKey: "resource", callback: ResourceOperationCallback$1): UnsubscribeToken$1;
-  subscribe(cacheKey: "document" | RequestKey, callback: DocumentOperationCallback$1): UnsubscribeToken$1;
-  /**
-   * remove a previous subscription
-   *
-   * @public
-   */
-  unsubscribe(token: UnsubscribeToken$1): void;
-  /**
-   * Custom Caches and Application Code should not call this method directly.
-   *
-   * When notifying `'attributes'` or `'relationships'` for many keys on the
-   * same `cacheKey` at once (for instance, when a bulk update to a single
-   * record touches many fields) `key` may be supplied as a `Set<string>`
-   * instead of being called once per key. The `Set` is iterated as-is (it is
-   * never converted to or from an array internally). This delivers the
-   * exact same sequence of individual notifications to subscribers (each
-   * subscriber callback is still invoked once per key, in order) while
-   * paying the per-call overhead (validity checks, subscriber lookups,
-   * buffer/flush scheduling) only once for the whole batch instead of once
-   * per key.
-   *
-   * A `channel` may be supplied for the `'attributes'`/`'relationships'`
-   * namespaces. Tagging a notification `'local'` declares "only the local
-   * (reconciled/editable) view changed"; tagging it `'remote'` declares "only
-   * the remote view changed". Each tag is delivered only to that channel's
-   * subscribers. Omitting the channel reaches every subscriber regardless of
-   * its channel. See {@link NotificationChannel}.
-   *
-   * | notify ↓ subscribe → | `'local'` | `'remote'` | omitted (= `'local'`) |
-   * | -------------------- | --------- | ---------- | --------------------- |
-   * | `'local'`            | ✅        | ❌         | ✅                    |
-   * | `'remote'`           | ❌        | ✅         | ❌                    |
-   * | omitted              | ✅        | ✅         | ✅                    |
-   *
-   * @private
-   */
-  notify(cacheKey: ResourceKey, value: "attributes" | "relationships", key?: string | NotifyKeys | null, channel?: NotificationChannel): boolean;
-  notify(cacheKey: ResourceKey, value: "errors" | "meta" | "identity" | "state", key?: null): boolean;
-  notify(cacheKey: ResourceKey, value: CacheOperation$1, key?: null): boolean;
-  notify(cacheKey: RequestKey, value: DocumentCacheOperation$1, key?: null): boolean;
-}
-/**
- * This type exists for internal use only for
- * where intimate contracts still exist either for
- * the Test Suite or for Legacy code.
- *
- * @private
- */
-interface PrivateNotificationManager extends NotificationManager$1 {
-  _flush(): void;
-}
-//#endregion
 //#region src/store/deprecated/-private.d.ts
 interface BaseFinderOptions$1 {
   reload?: boolean;
@@ -2521,312 +2038,820 @@ interface SchemaService {
    * Queries whether the SchemaService recognizes `type` as a resource type
    *
    * @public
-   * @deprecated - use {@link SchemaService.hasResource | hasResource}
+   * @deprecated - use {@link SchemaService.hasResource | hasResource}
+   */
+  doesTypeExist?(type: string): boolean;
+  /**
+   * Queries whether the SchemaService recognizes `type` as a resource type
+   *
+   * @public
+   */
+  hasResource(resource: ObjectWithStringTypeProperty | ResourceKey): boolean;
+  /**
+   * Queries whether the SchemaService recognizes `type` as a resource trait
+   *
+   * @public
+   */
+  hasTrait(type: string): boolean;
+  /**
+   * Queries whether the given resource has the given trait
+   *
+   * @public
+   */
+  resourceHasTrait(resource: ObjectWithStringTypeProperty | ResourceKey, trait: string): boolean;
+  /**
+   * Queries for the fields of a given resource type or resource identity.
+   *
+   * Should error if the resource type is not recognized.
+   *
+   * @public
+   */
+  fields(resource: ObjectWithStringTypeProperty | ResourceKey): Map<string, FieldSchema>;
+  /**
+   * Queries for the fields of a given resource type or resource identity.
+   *
+   * Should error if the resource type is not recognized.
+   *
+   * @public
+   */
+  cacheFields?(resource: ObjectWithStringTypeProperty | ResourceKey): Map<string, Exclude<CacheableFieldSchema, IdentityField>>;
+  /**
+   * Returns the transformation registered with the name provided
+   * by `field.type`. Validates that the field is a valid transformable.
+   *
+   * @public
+   */
+  transformation(field: GenericField | ObjectField | ArrayField | ObjectWithStringTypeProperty): Transformation$1;
+  /**
+   * Returns the hash function registered with the name provided
+   * by `field.type`. Validates that the field is a valid HashField.
+   *
+   * @public
+   */
+  hashFn(field: HashField | ObjectWithStringTypeProperty): HashFn;
+  /**
+   * Returns the derivation registered with the name provided
+   * by `field.type`. Validates that the field is a valid DerivedField.
+   *
+   * @public
+   */
+  derivation(field: DerivedField | ObjectWithStringTypeProperty): Derivation;
+  /**
+   * Returns the schema for the provided resource type.
+   *
+   * @public
+   */
+  resource(resource: ObjectWithStringTypeProperty | ResourceKey): Schema;
+  /**
+   * Enables registration of multiple Schemas at once.
+   *
+   * This can be useful for either pre-loading schema information
+   * or for registering schema information delivered by API calls
+   * or other sources just-in-time.
+   *
+   * @public
+   */
+  registerResources(schemas: Schema[]): void;
+  /**
+   * Enables registration of a single Schema representing either
+   * a resource in PolarisMode or LegacyMode or an ObjectSchema
+   * representing an embedded structure in other schemas.
+   *
+   * This can be useful for either pre-loading schema information
+   * or for registering schema information delivered by API calls
+   * or other sources just-in-time.
+   *
+   * @public
+   */
+  registerResource(schema: Schema): void;
+  /**
+   * Enables registration of a transformation.
+   *
+   * The transformation can later be retrieved by the name
+   * attached to it's `[Type]` property.
+   *
+   * @public
+   */
+  registerTransformation(transform: Transformation$1): void;
+  /**
+   * Enables registration of a derivation.
+   *
+   * The derivation can later be retrieved by the name
+   * attached to it's `[Type]` property.
+   *
+   * @public
+   */
+  registerDerivation<R, T, FM extends ObjectValue | null>(derivation: Derivation<R, T, FM>): void;
+  /**
+   * Enables registration of a hashing function
+   *
+   * The hashing function can later be retrieved by the name
+   * attached to it's `[Type]` property.
+   *
+   * @public
+   */
+  registerHashFn(hashFn: HashFn): void;
+  /**
+   * Registers a {@link Trait} for use by resource schemas.
+   *
+   * Traits are re-usable collections of fields that can be composed to
+   * build up a resource schema. Often they represent polymorphic behaviors
+   * a resource should exhibit.
+   *
+   * When we finalize a resource, we walk its traits and apply their fields
+   * to the resource's fields. All specified traits must be registered by
+   * this time or an error will be thrown.
+   *
+   * Traits are applied left-to-right, with traits of traits being applied in the same
+   * way. Thus for the most part, application of traits is a post-order graph traversal
+   * problem.
+   *
+   * A trait is only ever processed once. If multiple traits (A, B, C) have the same
+   * trait (D) as a dependency, D will be included only once when first encountered by
+   * A.
+   *
+   * If a cycle exists such that trait A has trait B which has Trait A, trait A will
+   * be applied *after* trait B in production. In development a cycle error will be thrown.
+   *
+   * Fields are finalized on a "last wins principle". Thus traits appearing higher in
+   * the tree and further to the right of a traits array take precedence, with the
+   * resource's fields always being applied last and winning out.
+   *
+   * @public
+   */
+  registerTrait?(trait: Trait): void;
+  /**
+   * DEPRECATED - use `fields` instead
+   *
+   * Returns definitions for all properties of the specified resource
+   * that are considered "attributes". Generally these are properties
+   * that are not related to book-keeping state on the client and do
+   * not represent a linkage to another resource.
+   *
+   * The return value should be a dictionary of key:value pairs
+   * where the `key` is the attribute or property's name and `value`
+   * is an object with at least the property `name` which should also
+   * match `key`.
+   *
+   * Optionally, this object may also specify `type`, which should
+   * be a string reference to a `transform`, and `options` which
+   * should be dictionary in which any key:value pairs are permissable.
+   *
+   * For instance, when using `@warp-drive/legacy/model`, the following attribute
+   * definition:
+   *
+   * ```ts
+   * class extends Model {
+   *   @attr('string', { defaultValue: 'hello' }) greeting;
+   *   @attr('date') birthday;
+   *   @attr firstName;
+   * }
+   * ```
+   *
+   * Would be returned as:
+   *
+   * ```js
+   * {
+   *   greeting: { name: 'greeting', type: 'string', options: { defaultValue: 'hello' } },
+   *   birthday: { name: 'birthday', type: 'date' },
+   *   firstName: { name: 'firstName' }
+   * }
+   * ```
+   *
+   * @public
+   * @deprecated - use {@link SchemaService.fields | fields}
+   */
+  attributesDefinitionFor?(key: ResourceKey | ObjectWithStringTypeProperty): AttributesSchema;
+  /**
+   * DEPRECATED - use `fields` instead
+   *
+   * Returns definitions for all properties of the specified resource
+   * that are considered "relationships". Generally these are properties
+   * that represent a linkage to another resource.
+   *
+   * The return value should be a dictionary of key:value pairs
+   * where the `key` is the relationship or property's name and `value`
+   * is an object with at least the following properties:
+   *
+   * - `name` which should also match the `key` used in the dictionary.
+   * - `kind` which should be either `belongsTo` or `hasMany`
+   * - `type` which should be the related resource's string "type"
+   * - `options` which should be a dictionary allowing any key but with
+   *    at least the below keys present.
+   *
+   * - `options.async` a boolean representing whether data for this relationship is
+   *      typically loaded on-demand.
+   * - `options.inverse` a string or null representing the field name / key of the
+   *       corresponding relationship on the inverse resource.
+   *
+   * Additionally the following options properties are optional. See [Polymorphic Relationships](https://rfcs.emberjs.com/id/0793-polymporphic-relations-without-inheritance)
+   *
+   * - `options.polymorphic` a boolean representing whether multiple resource types
+   *    can be used to satisfy this relationship.
+   * - `options.as` a string representing the abstract type that the concrete side of
+   *    a relationship must specify when fulfilling a polymorphic inverse.
+   *
+   * For example, the following Model using @warp-drive/legacy/model would generate this relationships
+   * definition by default:
+   *
+   * ```js
+   * class User extends Model {
+   *   @belongsTo('user', { async: false, inverse: null }) bestFriend;
+   *   @hasMany('user', { async: true, inverse: 'friends' }) friends;
+   *   @hasMany('pet', { async: false, polymorphic: true, inverse: 'owner' }) pets;
+   * }
+   * ```
+   *
+   * Which would be returned as
+   *
+   * ```js
+   * {
+   *   bestFriend: {
+   *     name: 'bestFriend',
+   *     kind: 'belongsTo',
+   *     type: 'user',
+   *     options: {
+   *       async: false,
+   *       inverse: null
+   *     }
+   *   },
+   *   friends: {
+   *     name: 'friends',
+   *     kind: 'hasMany',
+   *     type: 'user',
+   *     options: {
+   *       async: true,
+   *       inverse: 'friends'
+   *     }
+   *   },
+   *   pets: {
+   *     name: 'pets',
+   *     kind: 'hasMany',
+   *     type: 'pet',
+   *     options: {
+   *       async: false,
+   *       polymorphic: true,
+   *       inverse: 'owner'
+   *     }
+   *   },
+   * }
+   * ```
+   *
+   * @public
+   * @deprecated - use {@link SchemaService.fields | fields}
    */
-  doesTypeExist?(type: string): boolean;
+  relationshipsDefinitionFor?(key: ResourceKey | ObjectWithStringTypeProperty): RelationshipsSchema;
   /**
-   * Queries whether the SchemaService recognizes `type` as a resource type
+   * Returns all known resource types
    *
    * @public
    */
-  hasResource(resource: ObjectWithStringTypeProperty | ResourceKey): boolean;
+  resourceTypes(): Readonly<string[]>;
   /**
-   * Queries whether the SchemaService recognizes `type` as a resource trait
+   * Register an extension for either objects or arrays
+   *
+   * See also {@link CAUTION_MEGA_DANGER_ZONE_Extension}
    *
    * @public
    */
-  hasTrait(type: string): boolean;
+  CAUTION_MEGA_DANGER_ZONE_registerExtension?(extension: CAUTION_MEGA_DANGER_ZONE_Extension): void;
   /**
-   * Queries whether the given resource has the given trait
+   * Retrieve the extension map for a resource
    *
    * @public
    */
-  resourceHasTrait(resource: ObjectWithStringTypeProperty | ResourceKey, trait: string): boolean;
+  CAUTION_MEGA_DANGER_ZONE_resourceExtensions?(resource: ResourceKey | {
+    type: string;
+  }): null | ProcessedExtension["features"];
   /**
-   * Queries for the fields of a given resource type or resource identity.
-   *
-   * Should error if the resource type is not recognized.
+   * Retrieve the extension map for an object field
    *
    * @public
    */
-  fields(resource: ObjectWithStringTypeProperty | ResourceKey): Map<string, FieldSchema>;
+  CAUTION_MEGA_DANGER_ZONE_objectExtensions?(field: ExtensibleField, resolvedType: string | null): null | ProcessedExtension["features"];
   /**
-   * Queries for the fields of a given resource type or resource identity.
+   * Retrieve the extension map for an array field
    *
-   * Should error if the resource type is not recognized.
+   * @public
+   */
+  CAUTION_MEGA_DANGER_ZONE_arrayExtensions?(field: ExtensibleField): null | ProcessedExtension["features"];
+  /**
+   * Check if a specific extension has been registered previously
    *
    * @public
    */
-  cacheFields?(resource: ObjectWithStringTypeProperty | ResourceKey): Map<string, Exclude<CacheableFieldSchema, IdentityField>>;
+  CAUTION_MEGA_DANGER_ZONE_hasExtension?(ext: {
+    kind: "object" | "array";
+    name: string;
+  }): boolean;
+}
+//#endregion
+//#region src/store/-private/managers/cache-key-manager.d.ts
+type TypeFromIdentifier<T> = T extends {
+  type: infer U;
+} ? U : string;
+type NarrowIdentifierIfPossible<T> = T extends ExistingResourceIdentifierObject ? PersistedResourceKey<TypeFromIdentifier<T>> : ResourceKey;
+/**
+ * Type-guard that returns `true` if the given value is a stable {@link ResourceKey}
+ * (as opposed to a {@link RequestKey} or arbitrary, not-yet-stabilized resource data).
+ */
+declare function isResourceKey(identifier: unknown): identifier is ResourceKey;
+/**
+ * Type-guard that returns `true` if the given value is a stable {@link RequestKey}
+ * (as opposed to a {@link ResourceKey} or arbitrary, not-yet-stabilized data).
+ */
+declare function isRequestKey(identifier: unknown): identifier is RequestKey;
+/**
+ * The identity of a field's value, as returned by {@link fieldValueIdentity}.
+ * Today only schema-object values (a `schema-object` field, or one element of
+ * a `schema-array`) have one: the concrete schema-object type the value
+ * resolves to, and the identity hash that type's `ObjectSchema` declares for
+ * it, or `null` when the schema declares `identity: null`.
+ */
+interface FieldValueIdentity {
+  type: string;
+  hash: string | null;
+}
+/**
+ * The identity of `value` as a value of `field`, when the field kind has one.
+ *
+ * A `schema-object` value, or one element of a `schema-array`, resolves to its
+ * concrete schema-object type and the identity hash that type's `ObjectSchema`
+ * declares (`null` when the schema declares `identity: null`). A
+ * non-polymorphic field names the type directly; a polymorphic field reads it
+ * off the value at `options.type` (default `'type'`), or computes it with the
+ * hash function named by `field.type` when `options.type` is `'@hash'`.
+ *
+ * Every other field kind, and any non-object value, has no identity and
+ * returns `null`.
+ */
+declare function fieldValueIdentity(schema: SchemaService, field: FieldSchema, value: unknown): FieldValueIdentity | null;
+interface KeyOptions {
+  lid: IdentifierMap;
+  id: IdentifierMap;
+}
+type TypeMap = {
+  [key: string]: KeyOptions;
+};
+type IdentifierMap = Map<string, ResourceKey>;
+type StableCache = {
+  resources: IdentifierMap;
+  documents: Map<string, RequestKey>;
+  resourcesByType: TypeMap;
+  polymorphicLidBackMap: Map<string, string[]>;
+};
+type MergeMethod = (targetIdentifier: ResourceKey, matchedIdentifier: ResourceKey, resourceData: unknown) => ResourceKey;
+/**
+Configures how unique identifier lid strings are generated by @ember-data/store.
+
+This configuration MUST occur prior to the store instance being created.
+
+Takes a method which can expect to receive various data as its first argument
+and the name of a bucket as its second argument.
+
+Currently there are two buckets, 'record' and 'document'.
+
+### Resource (`Record`) Identity
+
+If the bucket is `record` the method must return a unique (to at-least
+the given bucket) string identifier for the given data as a string to be
+used as the `lid` of an `Identifier` token.
+
+This method will only be called by either `getOrCreateRecordIdentifier` or
+`createIdentifierForNewRecord` when an identifier for the supplied data
+is not already known via `lid` or `type + id` combo and one needs to be
+generated or retrieved from a proprietary cache.
+
+`data` will be the same data argument provided to `getOrCreateRecordIdentifier`
+and in the `createIdentifierForNewRecord` case will be an object with
+only `type` as a key.
+
+```ts
+import { setIdentifierGenerationMethod } from '@warp-drive/core';
+
+export function initialize(applicationInstance) {
+// note how `count` here is now scoped to the application instance
+// for our generation method by being inside the closure provided
+// by the initialize function
+let count = 0;
+
+setIdentifierGenerationMethod((resource, bucket) => {
+return resource.lid || `my-key-${count++}`;
+});
+}
+
+export default {
+name: 'configure-ember-data-identifiers',
+initialize
+};
+```
+
+### Document Identity
+
+If the bucket is `document` the method will receive the associated
+immutable `request` passed to `store.request` as its first argument
+and should return a unique string for the given request if the document
+should be cached, and `null` if it should not be cached.
+
+Note, the request result will still be passed to the cache via `Cache.put`,
+but caches should take this as a signal that the document should not itself
+be cached, while its contents may still be used to update other cache state.
+
+The presence of `cacheOptions.key` on the request will take precedence
+for the document cache key, and this method will not be called if it is
+present.
+
+The default method implementation for this bucket is to return `null`
+for all requests whose method is not `GET`, and to return the `url` for
+those where it is.
+
+This means that queries via `POST` MUST provide `cacheOptions.key` or
+implement this hook.
+
+⚠️ Caution: Requests that do not have a `method` assigned are assumed to be `GET`
+
+@public
+*/
+declare function setIdentifierGenerationMethod(method: GenerationMethod | null): void;
+/**
+Configure a callback for when the identifier cache encounters new resource
+data for an existing resource.
+
+This configuration MUST occur prior to the store instance being created.
+
+```js
+import { setIdentifierUpdateMethod } from '@warp-drive/core';
+```
+
+Takes a method which can expect to receive an existing `Identifier` alongside
+some new data to consider as a second argument. This is an opportunity
+for secondary lookup tables and caches associated with the identifier
+to be amended.
+
+This method is called everytime `updateRecordIdentifier` is called and
+with the same arguments. It provides the opportunity to update secondary
+lookup tables for existing identifiers.
+
+It will always be called after an identifier created with `createIdentifierForNewRecord`
+has been committed, or after an update to the `record` a `RecordIdentifier`
+is assigned to has been committed. Committed here meaning that the server
+has acknowledged the update (for instance after a call to `.save()`)
+
+If `id` has not previously existed, it will be assigned to the `Identifier`
+prior to this `UpdateMethod` being called; however, calls to the parent method
+`updateRecordIdentifier` that attempt to change the `id` or calling update
+without providing an `id` when one is missing will throw an error.
+
+@public
+*/
+declare function setIdentifierUpdateMethod(method: UpdateMethod | null): void;
+/**
+Configure a callback for when the identifier cache is going to release an identifier.
+
+This configuration MUST occur prior to the store instance being created.
+
+```js
+import { setIdentifierForgetMethod } from '@warp-drive/core';
+```
+
+Takes method which can expect to receive an existing `Identifier` that should be eliminated
+from any secondary lookup tables or caches that the user has populated for it.
+
+@public
+*/
+declare function setIdentifierForgetMethod(method: ForgetMethod | null): void;
+/**
+Configure a callback for when the identifier cache is being torn down.
+
+This configuration MUST occur prior to the store instance being created.
+
+```js
+import { setIdentifierResetMethod } from '@warp-drive/core';
+```
+
+Takes a method which can expect to be called when the parent application is destroyed.
+
+If you have properly used a WeakMap to encapsulate the state of your customization
+to the application instance, you may not need to implement the `resetMethod`.
+
+@public
+*/
+declare function setIdentifierResetMethod(method: ResetMethod | null): void;
+/**
+Configure a callback for when the identifier cache is generating a new
+ResourceKey for a resource.
+
+This method controls the `type` and `id` that will be assigned to the
+`ResourceKey` that is created.
+
+This configuration MUST occur prior to the store instance being created.
+
+```js
+import { setKeyInfoForResource } from '@warp-drive/core';
+```
+
+@public
+*/
+declare function setKeyInfoForResource(method: KeyInfoMethod | null): void;
+/**
+ * Each instance of {@link Store} receives a unique instance of a CacheKeyManager.
+ *
+ * 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.
+ *
+ * @hideconstructor
+ * @public
+ */
+declare class CacheKeyManager {
+  constructor();
   /**
-   * Returns the transformation registered with the name provided
-   * by `field.type`. Validates that the field is a valid transformable.
+   * allows us to peek without generating when needed
+   * useful for the "create" case when we need to see if
+   * we are accidentally overwritting something
    *
-   * @public
+   * @private
    */
-  transformation(field: GenericField | ObjectField | ArrayField | ObjectWithStringTypeProperty): Transformation$1;
+  peekResourceKey(resource: ResourceIdentifierObject): ResourceKey | undefined;
   /**
-   * Returns the hash function registered with the name provided
-   * by `field.type`. Validates that the field is a valid HashField.
+   * Peeks the {@link RequestKey} for the given {@link RequestInfo}, but will not
+   * create one if none has been previously generated.
    *
    * @public
    */
-  hashFn(field: HashField | ObjectWithStringTypeProperty): HashFn;
+  peekRequestKey(request: RequestInfo): RequestKey | null;
   /**
-   * Returns the derivation registered with the name provided
-   * by `field.type`. Validates that the field is a valid DerivedField.
+   * Returns the {@link RequestKey} for the given {@link RequestInfo} if the request is
+   * considered cacheable. For cacheable requests, this method will create
+   * a RequestKey if none is found.
    *
-   * @public
-   */
-  derivation(field: DerivedField | ObjectWithStringTypeProperty): Derivation;
-  /**
-   * Returns the schema for the provided resource type.
+   * A `null` response indicates the request cannot/will not be cached,
+   * generally this means either
    *
-   * @public
-   */
-  resource(resource: ObjectWithStringTypeProperty | ResourceKey): Schema;
-  /**
-   * Enables registration of multiple Schemas at once.
+   * - {@link RequestInfo.cacheOptions.key} is not present on the `RequestInfo`
+   * - the request's method is `GET` but it has no `url`
    *
-   * This can be useful for either pre-loading schema information
-   * or for registering schema information delivered by API calls
-   * or other sources just-in-time.
+   * Generally you should not seek to cache requests that are not idempotent
+   * or have side effects, such as mutations that create, update or delete
+   * a resource.
    *
    * @public
    */
-  registerResources(schemas: Schema[]): void;
+  getOrCreateDocumentIdentifier(request: RequestInfo): RequestKey | null;
   /**
-   * Enables registration of a single Schema representing either
-   * a resource in PolarisMode or LegacyMode or an ObjectSchema
-   * representing an embedded structure in other schemas.
-   *
-   * This can be useful for either pre-loading schema information
-   * or for registering schema information delivered by API calls
-   * or other sources just-in-time.
-   *
-   * @public
-   */
-  registerResource(schema: Schema): void;
+	Returns the {@link ResourceKey} 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
+	
+	@public
+	*/
+  getOrCreateRecordIdentifier<T>(resource: T): NarrowIdentifierIfPossible<T>;
   /**
-   * Enables registration of a transformation.
-   *
-   * The transformation can later be retrieved by the name
-   * attached to it's `[Type]` property.
-   *
-   * @public
-   */
-  registerTransformation(transform: Transformation$1): void;
+	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')`.
+	
+	@public
+	*/
+  createIdentifierForNewRecord(data: {
+    type: string;
+    id?: string | null;
+    lid?: string;
+  }): ResourceKey;
   /**
-   * Enables registration of a derivation.
-   *
-   * The derivation can later be retrieved by the name
-   * attached to it's `[Type]` property.
-   *
-   * @public
-   */
-  registerDerivation<R, T, FM extends ObjectValue | null>(derivation: Derivation<R, T, FM>): void;
+	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.
+	
+	@public
+	*/
+  updateRecordIdentifier(identifierObject: ResourceKey, data: unknown): ResourceKey;
   /**
-   * Enables registration of a hashing function
-   *
-   * The hashing function can later be retrieved by the name
-   * attached to it's `[Type]` property.
-   *
-   * @public
-   */
-  registerHashFn(hashFn: HashFn): void;
+	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.
+	
+	@public
+	*/
+  forgetRecordIdentifier(identifierObject: ResourceKey): void;
+}
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+interface PrivateCacheKeyManager extends CacheKeyManager {
+  _cache: StableCache;
   /**
-   * Registers a {@link Trait} for use by resource schemas.
-   *
-   * Traits are re-usable collections of fields that can be composed to
-   * build up a resource schema. Often they represent polymorphic behaviors
-   * a resource should exhibit.
-   *
-   * When we finalize a resource, we walk its traits and apply their fields
-   * to the resource's fields. All specified traits must be registered by
-   * this time or an error will be thrown.
-   *
-   * Traits are applied left-to-right, with traits of traits being applied in the same
-   * way. Thus for the most part, application of traits is a post-order graph traversal
-   * problem.
-   *
-   * A trait is only ever processed once. If multiple traits (A, B, C) have the same
-   * trait (D) as a dependency, D will be included only once when first encountered by
-   * A.
-   *
-   * If a cycle exists such that trait A has trait B which has Trait A, trait A will
-   * be applied *after* trait B in production. In development a cycle error will be thrown.
-   *
-   * Fields are finalized on a "last wins principle". Thus traits appearing higher in
-   * the tree and further to the right of a traits array take precedence, with the
-   * resource's fields always being applied last and winning out.
+   * Internal hook to allow management of merge conflicts with identifiers.
    *
-   * @public
+   * we allow late binding of this private internal merge so that
+   * the cache can insert itself here to handle elimination of duplicates
    */
-  registerTrait?(trait: Trait): void;
+  __configureMerge(method: MergeMethod | null): void;
+  _mergeRecordIdentifiers(keyInfo: KeyInfo, identifier: ResourceKey, existingIdentifier: ResourceKey, data: unknown): ResourceKey;
+  destroy(): void;
+}
+//#endregion
+//#region src/store/-private/managers/notification-manager.d.ts
+type UnsubscribeToken$1 = object;
+/**
+ * The kinds of change notifications the {@link NotificationManager} can emit for a resource.
+ */
+type CacheOperation$1 = "added" | "removed" | "updated" | "state";
+/**
+ * The kinds of change notifications the {@link NotificationManager} can emit for a request document.
+ */
+type DocumentCacheOperation$1 = "invalidated" | "added" | "removed" | "updated" | "state";
+/**
+ * The full set of notification kinds the {@link NotificationManager} can emit for a resource,
+ * including both {@link CacheOperation}s and finer-grained field-level change notifications.
+ */
+type NotificationType = "attributes" | "relationships" | "identity" | "errors" | "meta" | CacheOperation$1;
+/**
+ * The shape accepted by {@link NotificationManager.notify} and
+ * {@link CacheCapabilitiesManager.notifyChange} for delivering many keys for
+ * the `'attributes'` or `'relationships'` namespaces in a single call
+ * instead of once per key.
+ *
+ * @since 5.9.0
+ * @public
+ */
+type NotifyKeys = Set<string>;
+/**
+ * A change to a resource's `attributes` or `relationships` can be relevant to
+ * a "local" view of the resource (its mutable/editable state), a "remote" view
+ * (its last-known-persisted state), or both.
+ *
+ * Each view subscribes to its own channel and, when notified, re-pulls its own
+ * projection of the data: a remote-only reader (e.g. PolarisMode's default
+ * immutable record) subscribes `'remote'` and re-reads remote state; an
+ * editable/reconciled reader (a legacy record, or an editable checkout)
+ * subscribes `'local'` (the same as omitting the channel) and re-reads local
+ * state. A notifier that knows which projection changed tags the notification
+ * with that channel; each tag is delivered only to that channel's subscribers.
+ * A change affecting both projections is either notified unscoped or once per
+ * channel. An unscoped notify cannot guarantee which view changed, so it
+ * reaches every subscriber -- this keeps every pre-channel `notify` callsite
+ * (and any custom cache that doesn't know about channels) fully compatible.
+ *
+ * The full delivery matrix:
+ *
+ * | notify ↓ subscribe → | `'local'` | `'remote'` | omitted (= `'local'`) |
+ * | -------------------- | --------- | ---------- | --------------------- |
+ * | `'local'`            | ✅        | ❌         | ✅                    |
+ * | `'remote'`           | ❌        | ✅         | ❌                    |
+ * | omitted              | ✅        | ✅         | ✅                    |
+ *
+ * Channel only applies to the `'attributes'` and `'relationships'`
+ * notification types. All other types (`'errors'`,
+ * `'identity'`, `'state'`, and the various `CacheOperation`/
+ * `DocumentCacheOperation` values) are never filtered by channel since they
+ * have no local/remote duality.
+ *
+ * @public
+ */
+type NotificationChannel = "local" | "remote";
+interface NotificationCallback$1 {
+  (cacheKey: ResourceKey, notificationType: "attributes" | "relationships", key?: string): void;
+  (cacheKey: ResourceKey, notificationType: "errors" | "meta" | "identity" | "state"): void;
+  (cacheKey: ResourceKey, notificationType: CacheOperation$1): void;
+}
+interface ResourceOperationCallback$1 {
+  (cacheKey: ResourceKey, notificationType: CacheOperation$1): void;
+}
+interface DocumentOperationCallback$1 {
+  (cacheKey: RequestKey, notificationType: DocumentCacheOperation$1): void;
+}
+/**
+ * The NotificationManager provides the ability to subscribe to
+ * changes to Cache state.
+ *
+ * This Feature is what allows WarpDrive to create subscriptions that
+ * work with any framework or change-notification system.
+ *
+ * @hideconstructor
+ * @public
+ */
+declare class NotificationManager$1 {
+  constructor(store: Store$1);
   /**
-   * DEPRECATED - use `fields` instead
-   *
-   * Returns definitions for all properties of the specified resource
-   * that are considered "attributes". Generally these are properties
-   * that are not related to book-keeping state on the client and do
-   * not represent a linkage to another resource.
-   *
-   * The return value should be a dictionary of key:value pairs
-   * where the `key` is the attribute or property's name and `value`
-   * is an object with at least the property `name` which should also
-   * match `key`.
-   *
-   * Optionally, this object may also specify `type`, which should
-   * be a string reference to a `transform`, and `options` which
-   * should be dictionary in which any key:value pairs are permissable.
-   *
-   * For instance, when using `@warp-drive/legacy/model`, the following attribute
-   * definition:
+   * Subscribe to changes for a given ResourceKey, RequestKey, or addition/removal of any resource
+   * or document.
    *
    * ```ts
-   * class extends Model {
-   *   @attr('string', { defaultValue: 'hello' }) greeting;
-   *   @attr('date') birthday;
-   *   @attr firstName;
-   * }
-   * ```
-   *
-   * Would be returned as:
+   * export type CacheOperation = 'added' | 'removed' | 'updated' | 'state';
    *
-   * ```js
-   * {
-   *   greeting: { name: 'greeting', type: 'string', options: { defaultValue: 'hello' } },
-   *   birthday: { name: 'birthday', type: 'date' },
-   *   firstName: { name: 'firstName' }
+   * export interface NotificationCallback {
+   *   (cacheKey: ResourceKey, notificationType: 'attributes' | 'relationships', key?: string): void;
+   *   (cacheKey: ResourceKey, notificationType: 'errors' | 'meta' | 'identity' | 'state'): void;
+   *   (cacheKey: ResourceKey, notificationType: NotificationType, key?: string): void;
    * }
-   * ```
-   *
-   * @public
-   * @deprecated - use {@link SchemaService.fields | fields}
-   */
-  attributesDefinitionFor?(key: ResourceKey | ObjectWithStringTypeProperty): AttributesSchema;
-  /**
-   * DEPRECATED - use `fields` instead
-   *
-   * Returns definitions for all properties of the specified resource
-   * that are considered "relationships". Generally these are properties
-   * that represent a linkage to another resource.
-   *
-   * The return value should be a dictionary of key:value pairs
-   * where the `key` is the relationship or property's name and `value`
-   * is an object with at least the following properties:
-   *
-   * - `name` which should also match the `key` used in the dictionary.
-   * - `kind` which should be either `belongsTo` or `hasMany`
-   * - `type` which should be the related resource's string "type"
-   * - `options` which should be a dictionary allowing any key but with
-   *    at least the below keys present.
-   *
-   * - `options.async` a boolean representing whether data for this relationship is
-   *      typically loaded on-demand.
-   * - `options.inverse` a string or null representing the field name / key of the
-   *       corresponding relationship on the inverse resource.
-   *
-   * Additionally the following options properties are optional. See [Polymorphic Relationships](https://rfcs.emberjs.com/id/0793-polymporphic-relations-without-inheritance)
-   *
-   * - `options.polymorphic` a boolean representing whether multiple resource types
-   *    can be used to satisfy this relationship.
-   * - `options.as` a string representing the abstract type that the concrete side of
-   *    a relationship must specify when fulfilling a polymorphic inverse.
-   *
-   * For example, the following Model using @warp-drive/legacy/model would generate this relationships
-   * definition by default:
-   *
-   * ```js
-   * class User extends Model {
-   *   @belongsTo('user', { async: false, inverse: null }) bestFriend;
-   *   @hasMany('user', { async: true, inverse: 'friends' }) friends;
-   *   @hasMany('pet', { async: false, polymorphic: true, inverse: 'owner' }) pets;
+   * export interface ResourceOperationCallback {
+   *   // resource updates
+   *   (cacheKey: ResourceKey, notificationType: CacheOperation): void;
    * }
-   * ```
-   *
-   * Which would be returned as
-   *
-   * ```js
-   * {
-   *   bestFriend: {
-   *     name: 'bestFriend',
-   *     kind: 'belongsTo',
-   *     type: 'user',
-   *     options: {
-   *       async: false,
-   *       inverse: null
-   *     }
-   *   },
-   *   friends: {
-   *     name: 'friends',
-   *     kind: 'hasMany',
-   *     type: 'user',
-   *     options: {
-   *       async: true,
-   *       inverse: 'friends'
-   *     }
-   *   },
-   *   pets: {
-   *     name: 'pets',
-   *     kind: 'hasMany',
-   *     type: 'pet',
-   *     options: {
-   *       async: false,
-   *       polymorphic: true,
-   *       inverse: 'owner'
-   *     }
-   *   },
+   * export interface DocumentOperationCallback {
+   *   // document updates
+   *   (cacheKey: RequestKey, notificationType: CacheOperation): void;
    * }
    * ```
    *
-   * @public
-   * @deprecated - use {@link SchemaService.fields | fields}
-   */
-  relationshipsDefinitionFor?(key: ResourceKey | ObjectWithStringTypeProperty): RelationshipsSchema;
-  /**
-   * Returns all known resource types
-   *
-   * @public
-   */
-  resourceTypes(): Readonly<string[]>;
-  /**
-   * Register an extension for either objects or arrays
+   * A `channel` may be provided when subscribing to a `ResourceKey`. Its
+   * effect is that the subscription skips `'attributes'`/`'relationships'`
+   * notifications explicitly tagged with the *other* channel; unscoped
+   * notifications, and notifications for all other notification types, always
+   * reach the subscriber. Subscribing `'local'` and omitting the channel are
+   * the same thing. See {@link NotificationChannel}.
    *
-   * See also {@link CAUTION_MEGA_DANGER_ZONE_Extension}
+   * | notify ↓ subscribe → | `'local'` | `'remote'` | omitted (= `'local'`) |
+   * | -------------------- | --------- | ---------- | --------------------- |
+   * | `'local'`            | ✅        | ❌         | ✅                    |
+   * | `'remote'`           | ❌        | ✅         | ❌                    |
+   * | omitted              | ✅        | ✅         | ✅                    |
    *
    * @public
+   * @return an opaque token to be used with unsubscribe
    */
-  CAUTION_MEGA_DANGER_ZONE_registerExtension?(extension: CAUTION_MEGA_DANGER_ZONE_Extension): void;
+  subscribe(cacheKey: ResourceKey, callback: NotificationCallback$1, channel?: NotificationChannel): UnsubscribeToken$1;
+  subscribe(cacheKey: "resource", callback: ResourceOperationCallback$1): UnsubscribeToken$1;
+  subscribe(cacheKey: "document" | RequestKey, callback: DocumentOperationCallback$1): UnsubscribeToken$1;
   /**
-   * Retrieve the extension map for a resource
+   * remove a previous subscription
    *
    * @public
    */
-  CAUTION_MEGA_DANGER_ZONE_resourceExtensions?(resource: ResourceKey | {
-    type: string;
-  }): null | ProcessedExtension["features"];
+  unsubscribe(token: UnsubscribeToken$1): void;
   /**
-   * Retrieve the extension map for an object field
+   * Custom Caches and Application Code should not call this method directly.
    *
-   * @public
-   */
-  CAUTION_MEGA_DANGER_ZONE_objectExtensions?(field: ExtensibleField, resolvedType: string | null): null | ProcessedExtension["features"];
-  /**
-   * Retrieve the extension map for an array field
+   * When notifying `'attributes'` or `'relationships'` for many keys on the
+   * same `cacheKey` at once (for instance, when a bulk update to a single
+   * record touches many fields) `key` may be supplied as a `Set<string>`
+   * instead of being called once per key. The `Set` is iterated as-is (it is
+   * never converted to or from an array internally). This delivers the
+   * exact same sequence of individual notifications to subscribers (each
+   * subscriber callback is still invoked once per key, in order) while
+   * paying the per-call overhead (validity checks, subscriber lookups,
+   * buffer/flush scheduling) only once for the whole batch instead of once
+   * per key.
    *
-   * @public
-   */
-  CAUTION_MEGA_DANGER_ZONE_arrayExtensions?(field: ExtensibleField): null | ProcessedExtension["features"];
-  /**
-   * Check if a specific extension has been registered previously
+   * A `channel` may be supplied for the `'attributes'`/`'relationships'`
+   * namespaces. Tagging a notification `'local'` declares "only the local
+   * (reconciled/editable) view changed"; tagging it `'remote'` declares "only
+   * the remote view changed". Each tag is delivered only to that channel's
+   * subscribers. Omitting the channel reaches every subscriber regardless of
+   * its channel. See {@link NotificationChannel}.
    *
-   * @public
+   * | notify ↓ subscribe → | `'local'` | `'remote'` | omitted (= `'local'`) |
+   * | -------------------- | --------- | ---------- | --------------------- |
+   * | `'local'`            | ✅        | ❌         | ✅                    |
+   * | `'remote'`           | ❌        | ✅         | ❌                    |
+   * | omitted              | ✅        | ✅         | ✅                    |
+   *
+   * @private
    */
-  CAUTION_MEGA_DANGER_ZONE_hasExtension?(ext: {
-    kind: "object" | "array";
-    name: string;
-  }): boolean;
+  notify(cacheKey: ResourceKey, value: "attributes" | "relationships", key?: string | NotifyKeys | null, channel?: NotificationChannel): boolean;
+  notify(cacheKey: ResourceKey, value: "errors" | "meta" | "identity" | "state", key?: null): boolean;
+  notify(cacheKey: ResourceKey, value: CacheOperation$1, key?: null): boolean;
+  notify(cacheKey: RequestKey, value: DocumentCacheOperation$1, key?: null): boolean;
+}
+/**
+ * This type exists for internal use only for
+ * where intimate contracts still exist either for
+ * the Test Suite or for Legacy code.
+ *
+ * @private
+ */
+interface PrivateNotificationManager extends NotificationManager$1 {
+  _flush(): void;
 }
 //#endregion
 //#region src/store/-types/q/cache-capabilities-manager.d.ts
@@ -3203,7 +3228,11 @@ interface Cache {
    * Push resource data from a remote source into the cache for this ResourceKey
    *
    * @public
-   * @return if `hasRecord` is true then calculated key changes should be returned
+   * @return when `hasRecord` is true, the names of the attributes whose persisted value
+   *   this push changed, or `undefined` when none did. A key counts as changed when the
+   *   value the cache holds for it moved, whether or not a local edit already held the new
+   *   value; a value the schema considers equal (for instance, a schema-object with a
+   *   matching identity hash) does not count. Otherwise `void`.
    */
   upsert(cacheKey: ResourceKey, data: ResourceBlob, hasRecord: boolean): void | string[];
   /**
@@ -3284,7 +3313,7 @@ interface Cache {
    * @param cacheKey - the primary ResourceKey that was operated on
    * @param result - a document in the cache format containing any updated data
    */
-  didCommit(cacheKey: ResourceKey, result: StructuredDataDocument<SingleResourceDataDocument> | null): SingleResourceDataDocument;
+  didCommit(cacheKey: ResourceKey, result: StructuredDataDocument<SingleResourceDataDocument<ExistingResourceObject, ExistingResourceObject>> | null): SingleResourceDataDocument;
   /**
    * [LIFECYCLE] Signals to the cache that a set of resources
    * was successfully updated as part of a save transaction that
@@ -3294,7 +3323,7 @@ interface Cache {
    * @param cacheKey - the primary ResourceKeys that were operated on
    * @param result - a document in the cache format containing any updated data
    */
-  didCommit(cacheKey: ResourceKey[], result: StructuredDataDocument<SingleResourceDataDocument> | null): SingleResourceDataDocument;
+  didCommit(cacheKey: ResourceKey[], result: StructuredDataDocument<SingleResourceDataDocument<ExistingResourceObject, ExistingResourceObject>> | null): SingleResourceDataDocument;
   /**
    * [LIFECYCLE] Signals to the cache that a set of resources
    * was successfully updated as part of a save transaction that
@@ -3304,7 +3333,7 @@ interface Cache {
    * @param cacheKey - the primary ResourceKeys that were operated on
    * @param result - a document in the cache format containing any updated data
    */
-  didCommit(cacheKey: ResourceKey[], result: StructuredDataDocument<CollectionResourceDataDocument> | null): CollectionResourceDataDocument;
+  didCommit(cacheKey: ResourceKey[], result: StructuredDataDocument<CollectionResourceDataDocument<ExistingResourceObject>> | null): CollectionResourceDataDocument;
   /**
    * [LIFECYCLE] Signals to the cache that a resource
    * was update via a save transaction failed.
@@ -4080,11 +4109,23 @@ declare function withResponseType<T>(obj: RequestInfo): RequestInfo<T> & {
  * result.content.data; // will have type User
  * ```
  *
+ * Pass a second type param to declare the `meta` the endpoint returns:
+ *
+ * ```ts
+ * type PageMeta = { page: { limit: number; offset: number }; total?: number };
+ *
+ * const result = await store.request(
+ *   withReactiveResponse<User[], PageMeta>({ url: '/users' })
+ * );
+ *
+ * result.content.meta?.total; // number | undefined
+ * ```
+ *
  * @public
  */
-declare function withReactiveResponse<T>(obj: RequestInfo): RequestInfo<ReactiveDataDocument<T>> & {
+declare function withReactiveResponse<T, M extends Meta | undefined = Meta | undefined, E extends object = object, EM extends Meta | undefined = M>(obj: RequestInfo): RequestInfo<ReactiveDataDocument<T, M, E, EM>> & {
   /** The branded response type. Present only at the type level; carries no runtime value. */
-  [RequestSignature]: ReactiveDataDocument<T>;
+  [RequestSignature]: ReactiveDataDocument<T, M, E, EM>;
 };
 /**
  * @deprecated use {@link withResponseType} instead
@@ -4233,7 +4274,7 @@ interface CachePolicy {
 }
 //#endregion
 //#region src/reactive/-private/document.d.ts
-interface ReactiveDocumentBase<T> {
+interface ReactiveDocumentBase<T, M extends Meta | undefined = Meta | undefined, E extends object = object, EM extends Meta | undefined = M> {
   /**
    * The links object for this document, if any
    *
@@ -4248,12 +4289,6 @@ interface ReactiveDocumentBase<T> {
    * @public
    */
   readonly links?: PaginationLinks;
-  /**
-   * The meta object for this document, if any
-   *
-   * @public
-   */
-  readonly meta?: Meta;
   /**
    * The RequestKey associated with this document, if any
    *
@@ -4267,7 +4302,7 @@ interface ReactiveDocumentBase<T> {
    *
    * @public
    */
-  fetch(options?: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T>>;
+  fetch(options?: RequestInfo<ReactiveDocument<T, M, E, EM>>): Promise<ReactiveDocument<T, M, E, EM>>;
   /**
    * Fetches the next link for this document, returning a promise that resolves
    * with the new document when the request completes, or null  if there is no
@@ -4275,7 +4310,7 @@ interface ReactiveDocumentBase<T> {
    *
    * @public
    */
-  next(options?: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
+  next(options?: RequestInfo<ReactiveDocument<T, M, E, EM>>): Promise<ReactiveDocument<T, M, E, EM> | null>;
   /**
    * Fetches the prev link for this document, returning a promise that resolves
    * with the new document when the request completes, or null if there is no
@@ -4283,7 +4318,7 @@ interface ReactiveDocumentBase<T> {
    *
    * @public
    */
-  prev(options: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
+  prev(options: RequestInfo<ReactiveDocument<T, M, E, EM>>): Promise<ReactiveDocument<T, M, E, EM> | null>;
   /**
    * Fetches the first link for this document, returning a promise that resolves
    * with the new document when the request completes, or null if there is no
@@ -4291,7 +4326,7 @@ interface ReactiveDocumentBase<T> {
    *
    * @public
    */
-  first(options: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
+  first(options: RequestInfo<ReactiveDocument<T, M, E, EM>>): Promise<ReactiveDocument<T, M, E, EM> | null>;
   /**
    * Fetches the last link for this document, returning a promise that resolves
    * with the new document when the request completes, or null if there is no
@@ -4299,7 +4334,7 @@ interface ReactiveDocumentBase<T> {
    *
    * @public
    */
-  last(options: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
+  last(options: RequestInfo<ReactiveDocument<T, M, E, EM>>): Promise<ReactiveDocument<T, M, E, EM> | null>;
   /**
    * Implemented for `JSON.stringify` support.
    *
@@ -4314,13 +4349,55 @@ interface ReactiveDocumentBase<T> {
    */
   toJSON(): object;
 }
+/**
+ * The `meta` member of a reactive document.
+ *
+ * Optional when the meta type has not been narrowed — the default,
+ * `Meta | undefined`, is "any JSON object, or nothing" — and required once a
+ * request declares what its endpoint returns, so a declared key needs no `?.`.
+ *
+ * Keeping it optional at the default is what lets consumers keep deriving from
+ * these types: an interface that re-declares `meta?:`, a mirrored copy checked
+ * by mutual assignability, a `class ... implements`, an intersection with
+ * `{ meta?: X }`, and `satisfies` all continue to work.
+ *
+ * The check is `undefined extends M` and not `M extends undefined`: a naked
+ * type param on the left of a conditional distributes over the union default
+ * and yields `{ meta: Meta } | { meta?: undefined }` rather than one object
+ * type.
+ */
+type DocumentMeta<M extends Meta | undefined> = undefined extends M ? {
+  /**
+   * The meta object for this document, if any.
+   *
+   * @public
+   */
+  readonly meta?: M;
+} : {
+  /**
+   * The meta object for this document.
+   *
+   * Required because the request named the shape it returns — read a
+   * documented key directly, no cast, coercion, or `?.`.
+   *
+   * ```ts
+   * type PageMeta = { page: { limit: number; offset: number }; total?: number };
+   *
+   * const { content } = await store.request(query<User, PageMeta>('user'));
+   * content.meta.total; // number | undefined, not unknown
+   * ```
+   *
+   * @public
+   */
+  readonly meta: M;
+};
 /**
  * The variant of {@link ReactiveDocument} returned for a request whose
  * response contained no primary data, e.g. an error response.
  *
  * @public
  */
-interface ReactiveErrorDocument<T> extends ReactiveDocumentBase<T> {
+type ReactiveErrorDocument<T, EM extends Meta | undefined = Meta | undefined, E extends object = object, M extends Meta | undefined = EM> = ReactiveDocumentBase<T, M, E, EM> & DocumentMeta<EM> & {
   /**
    * The primary data for this document, if any.
    *
@@ -4336,17 +4413,21 @@ interface ReactiveErrorDocument<T> extends ReactiveDocumentBase<T> {
   /**
    * The errors returned by the API for this request, if any
    *
+   * The cache stores whatever the API sent without validating it, so by
+   * default this is `object` — no shape is promised. Requests that know what
+   * their endpoint returns may narrow it by supplying the `E` type param.
+   *
    * @public
    */
-  readonly errors: object[];
-}
+  readonly errors: E[];
+};
 /**
  * The variant of {@link ReactiveDocument} returned for a request whose
  * response contained primary data.
  *
  * @public
  */
-interface ReactiveDataDocument<T> extends ReactiveDocumentBase<T> {
+type ReactiveDataDocument<T, M extends Meta | undefined = Meta | undefined, E extends object = object, EM extends Meta | undefined = M> = ReactiveDocumentBase<T, M, E, EM> & DocumentMeta<M> & {
   /**
    * The primary data for this document, if any.
    *
@@ -4365,7 +4446,7 @@ interface ReactiveDataDocument<T> extends ReactiveDocumentBase<T> {
    * @public
    */
   readonly errors?: undefined;
-}
+};
 /**
  * A Document is a class that wraps the response content from a request to the API
  * returned by `Cache.put` or `Cache.peek`, converting ResourceKeys into
@@ -4377,7 +4458,7 @@ interface ReactiveDataDocument<T> extends ReactiveDocumentBase<T> {
  *
  * @public
  */
-type ReactiveDocument<T> = ReactiveDataDocument<T> | ReactiveErrorDocument<T>;
+type ReactiveDocument<T, M extends Meta | undefined = Meta | undefined, E extends object = object, EM extends Meta | undefined = M> = ReactiveDataDocument<T, M, E, EM> | ReactiveErrorDocument<T, EM, E, M>;
 //#endregion
 //#region src/store/-private/managers/cache-capabilities-manager.d.ts
 interface CacheCapabilitiesManager {
@@ -4519,7 +4600,8 @@ declare class CacheManager implements Cache {
    * Push resource data from a remote source into the cache for this ResourceKey
    *
    * @public
-   * @return if `hasRecord` is true then calculated key changes should be returned
+   * @return when `hasRecord` is true, the names of the attributes whose persisted value
+   *   this push changed, or `undefined` when none did. Otherwise `void`.
    */
   upsert(key: ResourceKey, data: unknown, hasRecord: boolean): void | string[];
   /**
@@ -4621,9 +4703,9 @@ declare class CacheManager implements Cache {
    *
    * @public
    */
-  didCommit(key: ResourceKey, result: StructuredDataDocument<SingleResourceDataDocument> | null): SingleResourceDataDocument;
-  didCommit(key: ResourceKey[], result: StructuredDataDocument<SingleResourceDataDocument> | null): SingleResourceDataDocument;
-  didCommit(key: ResourceKey[], result: StructuredDataDocument<CollectionResourceDataDocument> | null): CollectionResourceDataDocument;
+  didCommit(key: ResourceKey, result: StructuredDataDocument<SingleResourceDataDocument<ExistingResourceObject, ExistingResourceObject>> | null): SingleResourceDataDocument;
+  didCommit(key: ResourceKey[], result: StructuredDataDocument<SingleResourceDataDocument<ExistingResourceObject, ExistingResourceObject>> | null): SingleResourceDataDocument;
+  didCommit(key: ResourceKey[], result: StructuredDataDocument<CollectionResourceDataDocument<ExistingResourceObject>> | null): CollectionResourceDataDocument;
   /**
    * [LIFECYCLE] Signals to the cache that a resource
    * was update via a save transaction failed.
@@ -7963,7 +8045,7 @@ declare class DefaultCachePolicy implements CachePolicy {
 /**
  * @deprecated use {@link ReactiveDocument} instead
  */
-type Document<T> = ReactiveDocument<T>;
+type Document<T, M extends Meta | undefined = Meta | undefined, E extends object = object, EM extends Meta | undefined = M> = ReactiveDocument<T, M, E, EM>;
 /**
  * Options for setting up a Store instance with `useRecommendedStore`.
  */
@@ -9178,5 +9260,5 @@ declare function peekInternalSignal(signals: SignalStore | undefined, key: strin
  */
 declare function notifyInternalSignal(signal: WarpDriveSignal | undefined): void;
 //#endregion
-export { PrivateRequestStateService as $, Context$1 as $n, ExtensibleField as $t, PolicyConfig as A, EnableHydration as An, withReactiveResponse as At, logGroup as B, PostQueryRequestOptions as Bn, GraphEdge as Bt, getPromiseState as C, setIdentifierResetMethod as Cn, ReactiveDocument as Ct, useRecommendedStore as D, ConstrainedRequestOptions as Dn, StoreRequestContext as Dt, StoreSetupOptions as E, CacheOptions as En, CacheHandler as Et, PrivateReactiveResource as F, ImmutableCreateRequestOptions as Fn, createDeferred as Ft, ensureStringId as G, ResponseInfo as Gn, Cache as Gt, createLegacyManyArray as H, RemotelyAccessibleIdentifier as Hn, ImplicitEdge as Ht, ReactiveResource as I, ImmutableDeleteRequestOptions as In, graphFor as It, PrivateStore as J, StructuredDataDocument as Jn, CacheCapabilitiesManager$1 as Jt, constructResource as K, STRUCTURED as Kn, ChangedAttributesHash as Kt, checkout as L, ImmutableHeaders as Ln, peekGraph as Lt, Fetch as M, FindRecordRequestOptions as Mn, Awaitable as Mt, instantiateRecord as N, HTTPMethod as Nn, getPromiseResult as Nt, CacheControlValue as O, CreateRequestOptions as On, StoreRequestInput as Ot, teardownRecord as P, IS_FUTURE as Pn, setPromiseResult as Pt, FindRecordQuery as Q, FetchError as Qn, CAUTION_MEGA_DANGER_ZONE_Extension as Qt, commit as R, ImmutableRequestInfo as Rn, isBelongsTo as Rt, ResolvedPromise as S, setIdentifierGenerationMethod as Sn, ReactiveDataDocument as St, Document as T, setKeyInfoForResource as Tn, CachePolicy as Tt, normalizeModelName as U, RequestContext as Un, CollectionEdge as Ut, LegacyManyArray as V, QueryRequestOptions as Vn, ResourceEdge as Vt, coerceId as W, RequestInfo as Wn, UpgradedMeta as Wt, assertPrivateStore as X, StructuredErrorDocument as Xn, RelationshipsSchema as Xt, Store$1 as Y, StructuredDocument as Yn, AttributesSchema as Yt, isPrivateStore as Z, UpdateRequestOptions as Zn, SchemaService as Zt, RequestState as _, NotificationType as _n, recordIdentifierFor as _t, notifyInternalSignal as a, registerDerivations as an, NextFn as ar, fastPush as at, PromiseState as b, isResourceKey as bn, PrivateCacheCapabilitiesManager as bt, AutorefreshBehaviorCombos as c, FindAllOptions as cn, PrivateReactiveResourceArray as ct, RecoveryFeatures as d, QueryOptions as dn, Checkout as dt, ExtensionDef as en, CacheHandler$1 as er, Request$1 as et, RequestArgs as f, ModelSchema as fn, Context as ft, RequestLoadingState as g, NotificationManager$1 as gn, _clearCaches as gt, createRequestSubscription as h, NotificationChannel as hn, StoreMap as ht, makeInitializer as i, fromIdentity as in, ManagedRequestPriority as ir, RecordArrayManager as it, parseCacheControl as j, FindRecordOptions$2 as jn, withResponseType as jt, DefaultCachePolicy as k, DeleteRequestOptions as kn, withBrand as kt, ContentFeatures as l, FindRecordOptions as ln, ReactiveResourceArray as lt, SubscriptionArgs as m, DocumentCacheOperation$1 as mn, InstanceCache as mt, WarpDriveSignal as n, SchemaService$1 as nn, Future as nr, RequestStateService as nt, peekInternalSignal as o, withDefaults as on, RequestManager as or, LegacyQueryArray as ot, RequestSubscription as p, CacheOperation$1 as pn, NativeProxy as pt, CreateRecordProperties as q, SkipCache as qn, RelationshipDiff as qt, getOrCreateInternalSignal as r, Transformation as rn, Handler as rr, SaveRecordMutation as rt, withSignalStore as s, BaseFinderOptions as sn, LegacyLiveArray as st, SignalStore as t, ProcessedExtension as tn, Deferred as tr, RequestCacheRequestState as tt, DISPOSE as u, LegacyResourceQuery as un, ManagedArray as ut, getRequestState as v, NotifyKeys as vn, setRecordIdentifier as vt, ConfiguredStore as w, setIdentifierUpdateMethod as wn, ReactiveErrorDocument as wt, RejectedPromise as x, setIdentifierForgetMethod as xn, assertPrivateCapabilities as xt, PendingPromise as y, isRequestKey as yn, storeFor as yt, log as z, ImmutableUpdateRequestOptions as zn, Graph as zt };
-//# sourceMappingURL=internal-DtWOpxrR.d.ts.map
+export { PrivateRequestStateService as $, UpdateRequestOptions as $n, NotificationType as $t, PolicyConfig as A, CreateRequestOptions as An, withReactiveResponse as At, logGroup as B, ImmutableRequestInfo as Bn, GraphEdge as Bt, getPromiseState as C, FindAllOptions as Cn, ReactiveDocument as Ct, useRecommendedStore as D, ModelSchema as Dn, StoreRequestContext as Dt, StoreSetupOptions as E, QueryOptions as En, CacheHandler as Et, PrivateReactiveResource as F, HTTPMethod as Fn, createDeferred as Ft, ensureStringId as G, RequestContext as Gn, Cache as Gt, createLegacyManyArray as H, PostQueryRequestOptions as Hn, ImplicitEdge as Ht, ReactiveResource as I, IS_FUTURE as In, graphFor as It, PrivateStore as J, STRUCTURED as Jn, CacheCapabilitiesManager$1 as Jt, constructResource as K, RequestInfo as Kn, ChangedAttributesHash as Kt, checkout as L, ImmutableCreateRequestOptions as Ln, peekGraph as Lt, Fetch as M, EnableHydration as Mn, Awaitable as Mt, instantiateRecord as N, FindRecordOptions$2 as Nn, getPromiseResult as Nt, CacheControlValue as O, CacheOptions as On, StoreRequestInput as Ot, teardownRecord as P, FindRecordRequestOptions as Pn, setPromiseResult as Pt, FindRecordQuery as Q, StructuredErrorDocument as Qn, NotificationManager$1 as Qt, commit as R, ImmutableDeleteRequestOptions as Rn, isBelongsTo as Rt, ResolvedPromise as S, BaseFinderOptions as Sn, ReactiveDataDocument as St, Document as T, LegacyResourceQuery as Tn, CachePolicy as Tt, normalizeModelName as U, QueryRequestOptions as Un, CollectionEdge as Ut, LegacyManyArray as V, ImmutableUpdateRequestOptions as Vn, ResourceEdge as Vt, coerceId as W, RemotelyAccessibleIdentifier as Wn, UpgradedMeta as Wt, assertPrivateStore as X, StructuredDataDocument as Xn, DocumentCacheOperation$1 as Xt, Store$1 as Y, SkipCache as Yn, CacheOperation$1 as Yt, isPrivateStore as Z, StructuredDocument as Zn, NotificationChannel as Zt, RequestState as _, SchemaService$1 as _n, recordIdentifierFor as _t, notifyInternalSignal as a, setIdentifierForgetMethod as an, Handler as ar, fastPush as at, PromiseState as b, registerDerivations as bn, PrivateCacheCapabilitiesManager as bt, AutorefreshBehaviorCombos as c, setIdentifierUpdateMethod as cn, RequestManager as cr, PrivateReactiveResourceArray as ct, RecoveryFeatures as d, RelationshipsSchema as dn, Checkout as dt, NotifyKeys as en, FetchError as er, Request$1 as et, RequestArgs as f, SchemaService as fn, Context as ft, RequestLoadingState as g, ProcessedExtension as gn, _clearCaches as gt, createRequestSubscription as h, ExtensionDef as hn, StoreMap as ht, makeInitializer as i, isResourceKey as in, Future as ir, RecordArrayManager as it, parseCacheControl as j, DeleteRequestOptions as jn, withResponseType as jt, DefaultCachePolicy as k, ConstrainedRequestOptions as kn, withBrand as kt, ContentFeatures as l, setKeyInfoForResource as ln, ReactiveResourceArray as lt, SubscriptionArgs as m, ExtensibleField as mn, InstanceCache as mt, WarpDriveSignal as n, fieldValueIdentity as nn, CacheHandler$1 as nr, RequestStateService as nt, peekInternalSignal as o, setIdentifierGenerationMethod as on, ManagedRequestPriority as or, LegacyQueryArray as ot, RequestSubscription as p, CAUTION_MEGA_DANGER_ZONE_Extension as pn, NativeProxy as pt, CreateRecordProperties as q, ResponseInfo as qn, RelationshipDiff as qt, getOrCreateInternalSignal as r, isRequestKey as rn, Deferred as rr, SaveRecordMutation as rt, withSignalStore as s, setIdentifierResetMethod as sn, NextFn as sr, LegacyLiveArray as st, SignalStore as t, FieldValueIdentity as tn, Context$1 as tr, RequestCacheRequestState as tt, DISPOSE as u, AttributesSchema as un, ManagedArray as ut, getRequestState as v, Transformation as vn, setRecordIdentifier as vt, ConfiguredStore as w, FindRecordOptions as wn, ReactiveErrorDocument as wt, RejectedPromise as x, withDefaults as xn, assertPrivateCapabilities as xt, PendingPromise as y, fromIdentity as yn, storeFor as yt, log as z, ImmutableHeaders as zn, Graph as zt };
+//# sourceMappingURL=internal-9XuWZdDv.d.ts.map