@warp-drive/core 5.7.0-alpha.1 → 5.7.0-alpha.11

package/declarations/store/deprecated/store.d.ts

@@ -363,11 +363,11 @@ declare module "../-private/store-service" {
 		@param id - optional object with options for the request only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved
 		@param options - if the first param is a string this will be the optional options for the request. See examples for available options.
 		*/
-		findRecord<T>(type: TypeFromInstance<T>, id: string | number, options?: FindRecordOptions<T>): Promise<T>;
+		findRecord<T>(type: TypeFromInstance<T>, id: string | number, options?: FindRecordOptions): Promise<T>;
 		/** @deprecated */
 		findRecord(type: string, id: string | number, options?: FindRecordOptions): Promise<unknown>;
 		/** @deprecated */
-		findRecord<T>(resource: ResourceIdentifierObject<TypeFromInstance<T>>, options?: FindRecordOptions<T>): Promise<T>;
+		findRecord<T>(resource: ResourceIdentifierObject<TypeFromInstance<T>>, options?: FindRecordOptions): Promise<T>;
 		/** @deprecated */
 		findRecord(resource: ResourceIdentifierObject, options?: FindRecordOptions): Promise<unknown>;
 		/**
@@ -548,7 +548,7 @@ declare module "../-private/store-service" {
 		@param type the name of the resource
 		@param options
 		*/
-		findAll<T>(type: TypeFromInstance<T>, options?: FindAllOptions<T>): Promise<LiveArray<T>>;
+		findAll<T>(type: TypeFromInstance<T>, options?: FindAllOptions): Promise<LiveArray<T>>;
 		/** @deprecated */
 		findAll(type: string, options?: FindAllOptions): Promise<LiveArray>;
 		/**
@@ -602,7 +602,7 @@ declare module "../-private/store-service" {
 		@param query a query to be used by the adapter
 		@param options optional, may include `adapterOptions` hash which will be passed to adapter.query
 		*/
-		query<T>(type: TypeFromInstance<T>, query: LegacyResourceQuery<T>, options?: QueryOptions): Promise<CollectionRecordArray<T>>;
+		query<T>(type: TypeFromInstance<T>, query: LegacyResourceQuery, options?: QueryOptions): Promise<CollectionRecordArray<T>>;
 		/** @deprecated */
 		query(type: string, query: LegacyResourceQuery, options?: QueryOptions): Promise<CollectionRecordArray>;
 		/**
@@ -704,7 +704,7 @@ declare module "../-private/store-service" {
 		@param options optional, may include `adapterOptions` hash which will be passed to adapter.queryRecord
 		@return promise which resolves with the found record or `null`
 		*/
-		queryRecord<T>(type: TypeFromInstance<T>, query: LegacyResourceQuery<T>, options?: QueryOptions): Promise<T | null>;
+		queryRecord<T>(type: TypeFromInstance<T>, query: LegacyResourceQuery, options?: QueryOptions): Promise<T | null>;
 		/** @deprecated */
 		queryRecord(type: string, query: LegacyResourceQuery, options?: QueryOptions): Promise<unknown | null>;
 		/**

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

@@ -1,7 +1,7 @@
 type UniversalTransientKey = "REQ_ID";
 type UniversalKey = `(transient) ${UniversalTransientKey}` | "RequestMap" | "PromiseCache" | "RequestCache" | "SkipCache" | "EnableHydration" | "WarpDriveRuntimeConfig";
 type TransientKey = "transactionRef" | "configuredGenerationMethod" | "configuredUpdateMethod" | "configuredForgetMethod" | "configuredResetMethod" | "configuredKeyInfoMethod" | "signalHooks";
-type GlobalKey = `(transient) ${TransientKey}` | "AdapterError" | "InvalidError" | "TimeoutError" | "AbortError" | "UnauthorizedError" | "ForbiddenError" | "NotFoundError" | "ConflictError" | "ServerError" | "#{}" | "#[]" | "Signals" | "AvailableShims" | "FAKE_ARR" | "#source" | "#update" | "#notify" | "IS_COLLECTION" | "Touching" | "RequestPromise" | "SaveOp" | "LEGACY_SUPPORT" | "LegacySupport" | "Graphs" | "IS_FROZEN" | "IS_CACHE_HANDLER" | "CONFIG" | "DEBUG_MAP" | "IDENTIFIERS" | "DOCUMENTS" | "CacheForIdentifierCache" | "RecordCache" | "StoreMap" | "Store" | "$type" | "TransformName" | "RequestSignature" | "IS_FUTURE" | "DOC" | "ManagedArrayMap" | "ManagedObjectMap" | "Support" | "SOURCE" | "MUTATE" | "Destroy" | "Identifier" | "Editable" | "EmbeddedPath" | "EmbeddedField" | "Parent" | "Checkout" | "Legacy";
+type GlobalKey = `(transient) ${TransientKey}` | "AdapterError" | "InvalidError" | "TimeoutError" | "AbortError" | "UnauthorizedError" | "ForbiddenError" | "NotFoundError" | "ConflictError" | "ServerError" | "#{}" | "#[]" | "Signals" | "AvailableShims" | "FAKE_ARR" | "#source" | "#update" | "#notify" | "IS_COLLECTION" | "Touching" | "RequestPromise" | "SaveOp" | "LEGACY_SUPPORT" | "LegacySupport" | "Graphs" | "IS_FROZEN" | "IS_CACHE_HANDLER" | "CONFIG" | "DEBUG_MAP" | "IDENTIFIERS" | "DOCUMENTS" | "CacheForIdentifierCache" | "RecordCache" | "StoreMap" | "Store" | "$type" | "TransformName" | "RequestSignature" | "IS_FUTURE" | "DOC" | "ManagedArrayMap" | "ManagedObjectMap" | "Support" | "SOURCE" | "MUTATE" | "Destroy" | "Checkout" | "Context";
 type UniqueSymbol<T extends string> = `___(unique) Symbol(${T})`;
 type UniqueSymbolOr<
 	T,

package/declarations/types/cache.d.ts

@@ -461,8 +461,6 @@ export interface Cache {
 	* Query the cache for any validation errors applicable to the given resource.
 	*
 	* @public
-	* @param identifier
-	* @return {JsonApiError[]}
 	*/
 	getErrors(identifier: StableRecordIdentifier): ApiError[];
 	/**

package/declarations/types/params.d.ts

@@ -1,9 +1,8 @@
-import type { Includes, TypedRecordInstance } from "./record.js";
 export type SerializablePrimitive = string | number | boolean | null;
 export type Serializable = SerializablePrimitive | SerializablePrimitive[];
 export type QueryParamsSerializationOptions = {
 	arrayFormat?: "bracket" | "indices" | "repeat" | "comma";
 };
-export type QueryParamsSource<T = unknown> = ({
-	include?: T extends TypedRecordInstance ? Includes<T>[] : string | string[];
+export type QueryParamsSource = ({
+	include?: string | string[];
 } & Record<Exclude<string, "include">, Serializable>) | URLSearchParams;

package/declarations/types/request.d.ts

@@ -1,6 +1,6 @@
 import type { StableRecordIdentifier } from "./identifier.js";
 import type { QueryParamsSerializationOptions } from "./params.js";
-import type { ExtractSuggestedCacheTypes, Includes, TypedRecordInstance, TypeFromInstanceOrString } from "./record.js";
+import type { ExtractSuggestedCacheTypes, TypedRecordInstance, TypeFromInstanceOrString } from "./record.js";
 import type { ResourceIdentifierObject } from "./spec/json-api-raw.js";
 import type { RequestSignature } from "./symbols.js";
 type Store = unknown;
@@ -152,17 +152,17 @@ export type RemotelyAccessibleIdentifier<T extends string = string> = {
 	type: T;
 	lid?: string;
 };
-export type ConstrainedRequestOptions = {
+export interface ConstrainedRequestOptions {
 	reload?: boolean;
 	backgroundReload?: boolean;
 	host?: string;
 	namespace?: string;
 	resourcePath?: string;
 	urlParamsSettings?: QueryParamsSerializationOptions;
-};
-export type FindRecordOptions<T = unknown> = ConstrainedRequestOptions & {
-	include?: T extends TypedRecordInstance ? Includes<T>[] : string | string[];
-};
+}
+export interface FindRecordOptions extends ConstrainedRequestOptions {
+	include?: string | string[];
+}
 export interface StructuredDataDocument<T> {
 	[STRUCTURED]?: true;
 	/**

package/declarations/types/schema/fields.d.ts

@@ -1,5 +1,15 @@
 import type { ObjectValue, PrimitiveValue, Value } from "../json/raw.js";
 /**
+* Options signature for Legacy Attributes.
+*/
+export interface AttrOptions {
+	/**
+	* A primitive value or a function which produces a value.
+	*/
+	defaultValue?: PrimitiveValue | (() => Value);
+	[key: string]: Value | (() => Value) | undefined;
+}
+/**
 * A generic "field" that can be used to define
 * primitive value fields.
 *
@@ -29,7 +39,30 @@ export interface GenericField {
 	*/
 	name: string;
 	/**
-	* the name of the transform to use, if any
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link GenericField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
+	* the name of the {@link Transformation} to use, if any
 	*
 	* @public
 	*/
@@ -234,6 +267,27 @@ export interface IdentityField {
 	* @public
 	*/
 	name: string;
+	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link IdentityField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   entityUrn: '324523-sadf34-345'
+	* }
+	* ```
+	*
+	* But the app desires to use `record.id; // '324523-sadf34-345'`
+	*
+	* Then `name` would be set to `'id'` and
+	* `sourceKey` would be set to `'entityUrn'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
 }
 /**
 * Represents a specialized field whose computed value
@@ -250,7 +304,7 @@ export interface IdentityField {
 * perform those itself.
 *
 * A schema-array can declare its "key" value to be `@hash` if
-* a schema-object has such a field.
+* the schema-objects it contains have such a field.
 *
 * Only one hash field is permittable per schema-object, and
 * it should be placed in the `ResourceSchema`'s `@id` field
@@ -374,6 +428,29 @@ export interface ObjectField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link ObjectField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of a transform to pass the entire object
 	* through before displaying or serializing it.
 	*
@@ -409,11 +486,13 @@ export interface ObjectField {
 /**
 * Represents a field whose value is an object
 * with a well-defined structure described by
-* a non-resource schema.
+* a schema-object (a non-resource schema).
 *
 * If the object's structure is not well-defined,
 * use 'object' instead.
 *
+* By default, a SchemaObject within
+*
 * @public
 */
 export interface SchemaObjectField {
@@ -430,12 +509,42 @@ export interface SchemaObjectField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link SchemaObjectField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
+	* If the field is not polymorphic:
+	*
 	* The name of the ObjectSchema that describes the
 	* structure of the object.
 	*
+	* If the field is polymorphic:
+	*
+	* The name of the hashFn to use to extract
+	* the type from the contained value or null.
+	*
 	* @public
 	*/
-	type: string;
+	type: string | null;
 	/**
 	* Options for configuring the behavior of the
 	* SchemaObject.
@@ -446,6 +555,15 @@ export interface SchemaObjectField {
 	* @public
 	*/
 	options?: {
+		/**
+		* If true, if no value for this field exists in the cache,
+		* an empty `{}` will be used as the source for a new SchemaObject
+		* of the associated schema type, as opposed to the field's
+		* value being `null`.
+		*
+		* If `polymorphic` is `true`, defaultValue will be considered `false`.
+		*/
+		defaultValue?: boolean;
 		/**
 		* ::: warning ⚠️ Dangerous Feature Ahead
 		* :::
@@ -472,7 +590,15 @@ export interface SchemaObjectField {
 		* If the SchemaObject is Polymorphic, the key on the raw cache data to use
 		* as the "resource-type" value for the schema-object.
 		*
-		* Defaults to "type".
+		* The default is `'type'`.
+		*
+		* Valid options are:
+		*
+		* - `'@hash'`                : will lookup the `@hash` function specified by
+		*       SchemaObjectField.type and use it to calculate the type for each value.
+		* - \<field-name> (string)   : the name of a field to use as the key, only GenericFields (kind `field`)
+		*       Are valid field names for this purpose. The cache state without transforms applied will be
+		*       used when comparing values.
 		*
 		* @public
 		*/
@@ -502,6 +628,29 @@ export interface ArrayField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link ArrayField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of a transform to pass each item
 	* in the array through before displaying or
 	* or serializing it.
@@ -558,12 +707,42 @@ export interface SchemaArrayField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link SchemaArrayField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
+	* If the SchemaArray is not polymorphic:
+	*
 	* The name of the ObjectSchema that describes the
 	* structure of the objects in the array.
 	*
+	* If the SchemaArray is polymorphic:
+	*
+	* The name of the hashFn to use to extract
+	* the type from contained members or null.
+	*
 	* @public
 	*/
-	type: string;
+	type: string | null;
 	/**
 	* Options for configuring the behavior of the
 	* SchemaArray.
@@ -577,13 +756,13 @@ export interface SchemaArrayField {
 	*
 	* Valid options are:
 	*
-	* - `'@identity'` (default) : the cached object's referential identity will be used.
+	* - `'@identity'`(default)  : the cached object's referential identity will be used.
 	*       This may result in significant instability when resource data is updated from the API
 	* - `'@index'`              : the cached object's index in the array will be used.
 	*       This is only a good choice for arrays that rarely if ever change membership
 	* - `'@hash'`               : will lookup the `@hash` function supplied in the ResourceSchema for
 	*       The contained schema-object and use the computed result to determine and compare identity.
-	* - \<field-name> (string)   : the name of a field to use as the key, only GenericFields (kind `field`)
+	* - \<field-name> (string)  : the name of a field to use as the key, only GenericFields (kind `field`)
 	*       Are valid field names for this purpose. The cache state without transforms applied will be
 	*       used when comparing values. The field value should be unique enough to guarantee two schema-objects
 	*       of the same type will not collide.
@@ -594,6 +773,13 @@ export interface SchemaArrayField {
 	* @public
 	*/
 	options?: {
+		/**
+		* If true, if no value for this field exists in the cache,
+		* an empty `[]` will be used as the value of the field,
+		* as opposed to the field's value being `null`.
+		*
+		*/
+		defaultValue?: boolean;
 		/**
 		* ::: warning ⚠️ Dangerous Feature Ahead
 		* :::
@@ -655,8 +841,15 @@ export interface SchemaArrayField {
 		* If the SchemaArray is Polymorphic, the key on the raw cache data to use
 		* as the "resource-type" value for the schema-object.
 		*
-		* Defaults to "type".
+		* The default is `'type'`.
+		*
+		* Valid options are:
 		*
+		* - `'@hash'`                : will lookup the `@hash` function specified by
+		*       SchemaArrayField.type and use it to calculate the type for each value.
+		* - \<field-name> (string)   : the name of a field to use as the key, only GenericFields (kind `field`)
+		*       Are valid field names for this purpose. The cache state without transforms applied will be
+		*       used when comparing values.
 		*/
 		type?: string;
 	};
@@ -743,6 +936,29 @@ export interface ResourceField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link ResourceField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of the resource that this field
 	* refers to. In the case of a polymorphic
 	* relationship, this should be the trait
@@ -825,6 +1041,29 @@ export interface CollectionField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link CollectionField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of the resource that this field
 	* refers to. In the case of a polymorphic
 	* relationship, this should be the trait
@@ -925,6 +1164,29 @@ export interface LegacyAttributeField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link LegacyAttributeField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of the transform to use, if any
 	*
 	* @public
@@ -936,8 +1198,9 @@ export interface LegacyAttributeField {
 	* Must comply to the specific transform's options
 	* schema.
 	*
+	* See {@link AttrOptions} for more info.
 	*/
-	options?: ObjectValue;
+	options?: AttrOptions;
 }
 /**
 * > [!CAUTION]
@@ -964,6 +1227,29 @@ export interface LegacyBelongsToField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link LegacyBelongsToField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of the resource that this field
 	* refers to. In the case of a polymorphic
 	* relationship, this should be the trait
@@ -1094,6 +1380,29 @@ export interface LinksModeBelongsToField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link LinksModeBelongsToField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* The name of the resource that this field
 	* refers to. In the case of a polymorphic
 	* relationship, this should be the trait
@@ -1219,6 +1528,29 @@ export interface LegacyHasManyField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link LegacyHasManyField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* the name of the resource that this field
 	* refers to. In the case of a polymorphic
 	* relationship, this should be the trait
@@ -1367,6 +1699,29 @@ export interface LinksModeHasManyField {
 	*/
 	name: string;
 	/**
+	* The name of the field as returned by the API
+	* and inserted into the {@link Cache} if it differs
+	* from {@link LinksModeHasManyField.name}
+	*
+	* For instance, if the API returns:
+	*
+	* ```ts
+	* {
+	*   attributes: {
+	*     'first-name': 'Chris'
+	*   }
+	* }
+	* ```
+	*
+	* But the app desires to use `record.firstName; // 'Chris'`
+	*
+	* Then `name` would be set to `'firstName'` and
+	* `sourceKey` would be set to `'first-name'`.
+	*
+	* This option is only needed when the value differs from name.
+	*/
+	sourceKey?: string;
+	/**
 	* the name of the resource that this field
 	* refers to. In the case of a polymorphic
 	* relationship, this should be the trait
@@ -1548,12 +1903,23 @@ export type PolarisModeFieldSchema = GenericField | PolarisAliasField | LocalFie
 */
 export type FieldSchema = GenericField | LegacyAliasField | PolarisAliasField | LocalField | ObjectField | SchemaObjectField | ArrayField | SchemaArrayField | DerivedField | ResourceField | CollectionField | LegacyAttributeField | LegacyBelongsToField | LegacyHasManyField | LinksModeBelongsToField | LinksModeHasManyField;
 /**
+* A union of all possible LegacyMode and PolarisMode
+* field schemas that represent data that could be in
+* the cache.
+*
+* In other words this will not include types like alias
+* fields, local fields, or derived fields.
+*
+* @public
+*/
+export type CacheableFieldSchema = IdentityField | GenericField | ObjectField | SchemaObjectField | ArrayField | SchemaArrayField | ResourceField | CollectionField | LegacyAttributeField | LegacyBelongsToField | LegacyHasManyField | LinksModeBelongsToField | LinksModeHasManyField;
+/**
 * A union of all possible field schemas that can be
 * used in an ObjectSchema.
 *
 * @public
 */
-export type ObjectFieldSchema = GenericField | ObjectAliasField | LocalField | ObjectField | SchemaObjectField | ArrayField | SchemaArrayField | DerivedField;
+export type ObjectFieldSchema = LegacyAttributeField | GenericField | ObjectAliasField | LocalField | ObjectField | SchemaObjectField | ArrayField | SchemaArrayField | DerivedField;
 /**
 * Represents a schema for a primary resource in PolarisMode.
 *
@@ -1570,8 +1936,6 @@ export interface PolarisResourceSchema {
 	*
 	* for schema-objects, this should be either a HashField or null
 	*
-	* @property identity
-	* @type {IdentityField}
 	* @public
 	*/
 	identity: IdentityField;

package/dist/graph/-private.js

@@ -1,5 +1,5 @@
 import { deprecate, warn } from '@ember/debug';
-import { p as peekCache } from "../request-state-CejVJgdj.js";
+import { p as peekCache } from "../request-state-CeN66aML.js";
 import '../types/request.js';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import '../utils/string.js';

package/dist/{handler-D2jjnIA-.js → handler-SdXlte1w.js}

@@ -1,4 +1,4 @@
-import { K as ReactiveDocument } from "./request-state-CejVJgdj.js";
+import { K as ReactiveDocument } from "./request-state-CeN66aML.js";
 import { SkipCache, EnableHydration } from './types/request.js';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 const MUTATION_OPS = new Set(['createRecord', 'updateRecord', 'deleteRecord']);