@warp-drive/core 5.8.0-alpha.5 → 5.8.0-alpha.7

package/declarations/build-config.d.ts

@@ -1 +1,18 @@
-export { setConfig } from "@warp-drive/build-config";
+/**
+* This module provides a build-plugin that enables configuration of deprecations,
+* optional features, development/testing support and debug logging.
+*
+* Available settings include:
+*
+* - {@link LOGGING | debugging}
+* - {@link DEPRECATIONS | deprecations}
+* - {@link FEATURES | features}
+* - {@link WarpDriveConfig.polyfillUUID | polyfillUUID}
+* - {@link WarpDriveConfig.includeDataAdapterInProduction | includeDataAdapterInProduction}
+* - {@link WarpDriveConfig.compatWith | compatWith}
+*
+* @module
+*/
+import type { WarpDriveConfig } from "@warp-drive/build-config";
+export { setConfig, babelPlugin } from "@warp-drive/build-config";
+export type { WarpDriveConfig };

package/declarations/index.d.ts

@@ -2,13 +2,90 @@
 * @module
 * @mergeModuleWith <project>
 */
+import type { CAUTION_MEGA_DANGER_ZONE_Extension } from "./reactive.js";
 import type { ReactiveDocument } from "./reactive/-private/document.js";
-export { Fetch } from "./request/-private/fetch.js";
-export { RequestManager } from "./request/-private/manager.js";
-export { Store, type StoreRequestContext, CacheHandler, type CachePolicy, type StoreRequestInput, recordIdentifierFor, storeFor } from "./store/-private.js";
+import type { Handler } from "./request.js";
+import { Fetch } from "./request/-private/fetch.js";
+import { RequestManager } from "./request/-private/manager.js";
+import { CacheHandler, type CachePolicy, Store } from "./store/-private.js";
+import type { CacheCapabilitiesManager } from "./types.js";
+import type { Cache } from "./types/cache.js";
+import type { Derivation, HashFn, Transformation } from "./types/schema/concepts.js";
+import type { ObjectSchema, PolarisResourceSchema, Trait } from "./types/schema/fields.js";
+export { Fetch, RequestManager };
+export { Store, CacheHandler, type CachePolicy };
+export { type StoreRequestContext, type StoreRequestInput, recordIdentifierFor, storeFor } from "./store/-private.js";
 /**
 * @deprecated use `ReactiveDocument` instead
 */
 export type Document<T> = ReactiveDocument<T>;
 export type { DocumentCacheOperation, CacheOperation, NotificationType } from "./store/-private/managers/notification-manager.js";
 export { setIdentifierGenerationMethod, setIdentifierUpdateMethod, setIdentifierForgetMethod, setIdentifierResetMethod, setKeyInfoForResource } from "./store/-private/managers/cache-key-manager.js";
+/**
+* Options for setting up a Store instance with `useRecommendedStore`.
+*/
+export interface StoreSetupOptions {
+	/**
+	* The Cache implementation to use
+	*/
+	cache: new (capabilities: CacheCapabilitiesManager) => Cache;
+	/**
+	* The Cache policy to use.
+	*
+	* Defaults to {@link DefaultCachePolicy} configured to
+	* respect `Expires`, `X-WarpDrive-Expires`, and `Cache-Control` headers
+	* with a fallback to 30s soft expiration and 15m hard expiration.
+	*/
+	policy?: CachePolicy;
+	/**
+	* The request handlers to use. {@link Fetch} will automatically
+	* be added to the end of the handler chain and {@link CacheHandler}
+	* will automatically be added as the cache handler.
+	*/
+	handlers?: Handler[];
+	/**
+	* Schemas describing the structure of your resource data.
+	*
+	* See {@link PolarisResourceSchema,} and {@link ObjectSchema} for more information.
+	*/
+	schemas?: Array<PolarisResourceSchema | ObjectSchema>;
+	/**
+	* {@link Trait | Traits} to use with {@link PolarisResourceSchema, | Resource Schemas}
+	*/
+	traits?: Trait[];
+	/**
+	* {@link Derivation | Derivations} to use for derived fields.
+	*/
+	derivations?: Derivation[];
+	/**
+	* {@link Transformation | Transformations} to use for transforming fields.
+	*/
+	transformations?: Transformation[];
+	/**
+	* {@link HashFn | Hash Functions} to use for embedded object identity and polymorphic type calculations
+	*/
+	hashFns?: HashFn[];
+	/**
+	* {@link CAUTION_MEGA_DANGER_ZONE_Extension | Extensions} to use with resources, objects and arrays
+	* to provide custom behaviors and capabilities that are not described by Schema.
+	*
+	* This feature should only be used during a transition period to support migrating towards
+	* schemas from existing Model and ModelFragments implementations.
+	*/
+	CAUTION_MEGA_DANGER_ZONE_extensions?: CAUTION_MEGA_DANGER_ZONE_Extension[];
+}
+/**
+* Creates a configured Store class with recommended defaults
+* for schema handling, reactivity, caching, and request management.
+*
+* ```ts
+* import { useRecommendedStore } from '@warp-drive/core';
+* import { JSONAPICache } from '@warp-drive/json-api';
+*
+* export const Store = useRecommendedStore({
+*   cache: JSONAPICache,
+*   schemas: [],
+* });
+* ```
+*/
+export declare function useRecommendedStore(options: StoreSetupOptions, StoreKlass?: typeof Store): typeof Store;

package/declarations/reactive/-private/document.d.ts

@@ -3,25 +3,13 @@ import type { RequestKey } from "../../types/identifier.js";
 import type { ImmutableRequestInfo, RequestInfo } from "../../types/request.js";
 import type { ResourceDocument } from "../../types/spec/document.js";
 import type { Meta, PaginationLinks } from "../../types/spec/json-api-raw.js";
-/**
-* 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
-* ReactiveResource instances.
-*
-* It is not directly instantiated by the user, and its properties should not
-* be directly modified. Whether individual properties are mutable or not is
-* determined by the record instance itself.
-*
-* @public
-* @hideconstructor
-*/
-export declare class ReactiveDocument<T> {
+export interface ReactiveDocumentBase<T> {
 	/**
 	* The links object for this document, if any
 	*
 	* e.g.
 	*
-	* ```
+	* ```ts
 	* {
 	*   self: '/articles?page[number]=3',
 	* }
@@ -31,24 +19,6 @@ export declare class ReactiveDocument<T> {
 	*/
 	readonly links?: PaginationLinks;
 	/**
-	* The primary data for this document, if any.
-	*
-	* If this document has no primary data (e.g. because it is an error document)
-	* this property will be `undefined`.
-	*
-	* For collections this will be an array of record instances,
-	* for single resource requests it will be a single record instance or null.
-	*
-	* @public
-	*/
-	readonly data?: T;
-	/**
-	* The errors returned by the API for this request, if any
-	*
-	* @public
-	*/
-	readonly errors?: object[];
-	/**
 	* The meta object for this document, if any
 	*
 	* @public
@@ -60,18 +30,12 @@ export declare class ReactiveDocument<T> {
 	* @public
 	*/
 	readonly identifier: RequestKey | null;
-	constructor(store: Store, cacheKey: RequestKey | null, localCache: {
-		document: ResourceDocument;
-		request: ImmutableRequestInfo;
-	} | null);
 	/**
 	* Fetches the related link for this document, returning a promise that resolves
 	* with the document when the request completes. If no related link is present,
 	* will fallback to the self link if present
 	*
 	* @public
-	* @param {Object} options
-	* @return {Promise<Document>}
 	*/
 	fetch(options?: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T>>;
 	/**
@@ -80,8 +44,6 @@ export declare class ReactiveDocument<T> {
 	* next link.
 	*
 	* @public
-	* @param {Object} options
-	* @return {Promise<Document | null>}
 	*/
 	next(options?: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
 	/**
@@ -90,8 +52,6 @@ export declare class ReactiveDocument<T> {
 	* prev link.
 	*
 	* @public
-	* @param {Object} options
-	* @return {Promise<Document | null>}
 	*/
 	prev(options: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
 	/**
@@ -100,8 +60,6 @@ export declare class ReactiveDocument<T> {
 	* first link.
 	*
 	* @public
-	* @param {Object} options
-	* @return {Promise<Document | null>}
 	*/
 	first(options: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
 	/**
@@ -110,8 +68,6 @@ export declare class ReactiveDocument<T> {
 	* last link.
 	*
 	* @public
-	* @param {Object} options
-	* @return {Promise<Document | null>}
 	*/
 	last(options: RequestInfo<ReactiveDocument<T>>): Promise<ReactiveDocument<T> | null>;
 	/**
@@ -128,3 +84,59 @@ export declare class ReactiveDocument<T> {
 	*/
 	toJSON(): object;
 }
+export interface ReactiveErrorDocument<T> extends ReactiveDocumentBase<T> {
+	/**
+	* The primary data for this document, if any.
+	*
+	* If this document has no primary data (e.g. because it is an error document)
+	* this property will be `undefined`.
+	*
+	* For collections this will be an array of record instances,
+	* for single resource requests it will be a single record instance or null.
+	*
+	* @public
+	*/
+	readonly data?: undefined;
+	/**
+	* The errors returned by the API for this request, if any
+	*
+	* @public
+	*/
+	readonly errors: object[];
+}
+export interface ReactiveDataDocument<T> extends ReactiveDocumentBase<T> {
+	/**
+	* The primary data for this document, if any.
+	*
+	* If this document has no primary data (e.g. because it is an error document)
+	* this property will be `undefined`.
+	*
+	* For collections this will be an array of record instances,
+	* for single resource requests it will be a single record instance or null.
+	*
+	* @public
+	*/
+	readonly data: T;
+	/**
+	* The errors returned by the API for this request, if any
+	*
+	* @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
+* ReactiveResource instances.
+*
+* It is not directly instantiated by the user, and its properties should not
+* be directly modified. Whether individual properties are mutable or not is
+* determined by the record instance itself.
+*
+* @public
+*/
+export type ReactiveDocument<T> = ReactiveDataDocument<T> | ReactiveErrorDocument<T>;
+export declare function createReactiveDocument<T>(store: Store, cacheKey: RequestKey | null, localCache: {
+	document: ResourceDocument;
+	request: ImmutableRequestInfo;
+} | null): ReactiveDocument<T>;

package/declarations/reactive/-private/schema.d.ts

@@ -153,7 +153,7 @@ export interface ExtensibleField {
 * @param schema
 * @return {PolarisResourceSchema}
 */
-export declare function withDefaults(schema: WithPartial<PolarisResourceSchema, "identity">): ResourceSchema;
+export declare function withDefaults(schema: WithPartial<PolarisResourceSchema, "identity">): PolarisResourceSchema;
 interface FromIdentityDerivation {
 	(record: ReactiveResource, options: {
 		key: "lid";

package/declarations/reactive.d.ts

@@ -55,7 +55,7 @@
 * The shape of the object and the transformation of raw cache data into its
 * reactive form is controlled by a resource schema.
 *
-* For instance, lets say your API is a [{JSON:API}](https://jsonapi.org) and your store is using
+* For instance, lets say your API is a [{json:api}](https://jsonapi.org) and your store is using
 * the Cache provided by [@warp-drive/json-api](/api/@warp-drive/json-api), and a request
 * returns the following raw data:
 *
@@ -277,5 +277,6 @@ export { type CAUTION_MEGA_DANGER_ZONE_Extension, type ProcessedExtension, type
 export { commit, type ReactiveResource } from "./reactive/-private/record.js";
 export { checkout };
 export { Checkout } from "./reactive/-private/symbols.js";
-export { type ReactiveDocument } from "./reactive/-private/document.js";
+export { type ReactiveDocument, type ReactiveDataDocument, type ReactiveErrorDocument } from "./reactive/-private/document.js";
 export { getExpensiveRequestSubscription } from "./store/-private/new-core-tmp/expensive-subscription.js";
+export { createRequestSubscription, getRequestState, getPromiseState, type PromiseState, type RequestState } from "./store/-private.js";

package/declarations/request.d.ts

@@ -1,5 +1,30 @@
+import type { RequestInfo } from "./types/request.js";
+import type { RequestSignature } from "./types/symbols.js";
 export { createDeferred } from "./request/-private/future.js";
 export type { Future, Handler, CacheHandler, NextFn, Deferred, ManagedRequestPriority } from "./request/-private/types.js";
 export { setPromiseResult, getPromiseResult } from "./request/-private/promise-cache.js";
 export type { Awaitable } from "./request/-private/promise-cache.js";
 export type { Context } from "./request/-private/context.js";
+/**
+* Brands the supplied object with the supplied response type.
+*
+* ```ts
+* import type { ReactiveDataDocument } from '@warp-drive/core/reactive';
+* import { withResponseType } from '@warp-drive/core/request';
+* import type { User } from '#/data/user.ts'
+*
+* const result = await store.request(
+*  withResponseType<ReactiveDataDocument<User>>({ url: '/users/1' })
+* );
+*
+* result.content.data; // will have type User
+* ```
+*
+*/
+export declare function withResponseType<T>(obj: RequestInfo): RequestInfo<T> & {
+	[RequestSignature]: T;
+};
+/**
+* @deprecated use {@link withResponseType} instead
+*/
+export { withResponseType as withBrand };

package/declarations/store/-private/caches/instance-cache.d.ts

@@ -1,4 +1,4 @@
-import { ReactiveDocument } from "../../../reactive/-private/document.js";
+import { type ReactiveDocument } from "../../../reactive/-private/document.js";
 import type { Cache } from "../../../types/cache.js";
 import type { RequestKey, ResourceKey } from "../../../types/identifier.js";
 import type { TypedRecordInstance, TypeFromInstance } from "../../../types/record.js";

package/declarations/store/-private/default-cache-policy.d.ts

@@ -75,11 +75,65 @@ export interface CacheControlValue {
 * See also {@link CacheControlValue} and [Response Directives](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control#response_directives)
 *
 * @public
-* @param {String} header
-* @return {CacheControlValue}
 */
 export declare function parseCacheControl(header: string): CacheControlValue;
 /**
+* The constraint options for {@link PolicyConfig.constraints}
+*/
+export interface PolicyConfigConstraints {
+	/**
+	* Headers that should be checked for expiration.
+	*
+	*/
+	headers?: {
+		/**
+		* Whether the `Cache-Control` header should be checked for expiration.
+		* If `true`, then the `max-age` and `s-maxage` directives are used alongside
+		* the `Age` and `Date` headers to determine if the expiration time has passed.
+		*
+		* Other directives are ignored.
+		*
+		* 'Cache-Control' will take precedence over 'Expires' if both are present
+		* and both configured to be checked.
+		*
+		*/
+		"Cache-Control"?: boolean;
+		/**
+		* Whether the `Expires` header should be checked for expiration.
+		*
+		* If `true`, then the `Expires` header is used to caclulate the expiration time
+		* and determine if the expiration time has passed.
+		*
+		* 'Cache-Control' will take precedence over 'Expires' if both are present.
+		*
+		*/
+		Expires?: boolean;
+		/**
+		* Whether the `X-WarpDrive-Expires` header should be checked for expiration.
+		*
+		* If `true`, then the `X-WarpDrive-Expires` header is used to caclulate the expiration time
+		* and determine if the expiration time has passed.
+		*
+		* This header will take precedence over 'Cache-Control' and 'Expires' if all three are present.
+		*
+		* The header's value should be a [UTC date string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toUTCString).
+		*
+		*/
+		"X-WarpDrive-Expires"?: boolean;
+	};
+	/**
+	* A function that should be called to determine if the request is expired.
+	*
+	* If present, this function will be called with the request and should return
+	* `true` if the request is expired, `false` if it is not expired, and
+	* `null` if the expiration status is unknown.
+	*
+	* If the function does not return `null`,
+	*
+	*/
+	isExpired?: (request: StructuredDocument<ResourceDocument>) => boolean | null;
+}
+/**
 * The configuration options for the {@link DefaultCachePolicy}
 *
 * ```ts [app/services/store.ts]
@@ -103,10 +157,9 @@ export interface PolicyConfig {
 	*
 	* This is calculated against the `date` header of the response.
 	*
-	* If your API does not provide a `date` header, the `Fetch` handler
-	* provided by `@warp-drive/core` will automatically add
-	* it to responses if it is not present. Responses without a `date`
-	* header will be considered stale immediately.
+	* If your API does not provide a `date` header, the {@link Fetch} handler
+	* will automatically add it to responses if it is not present. Responses
+	* without a `date` header will be considered stale immediately.
 	*
 	*/
 	apiCacheSoftExpires: number;
@@ -118,10 +171,9 @@ export interface PolicyConfig {
 	*
 	* This is calculated against the `date` header of the response.
 	*
-	* If your API does not provide a `date` header, the `Fetch` handler
-	* provided by `@warp-drive/core` will automatically add
-	* it to responses if it is not present. Responses without a `date`
-	* header will be considered hard expired immediately.
+	* If your API does not provide a `date` header, the {@link Fetch} handler
+	* will automatically add it to responses if it is not present. Responses
+	* without a `date` header will be considered hard expired immediately.
 	*
 	*/
 	apiCacheHardExpires: number;
@@ -131,8 +183,8 @@ export interface PolicyConfig {
 	*
 	* This helps reduce flakiness and produce predictably rendered results in test suites.
 	*
-	* Requests that specifically set `cacheOptions.backgroundReload = true` will
-	* still be background reloaded in tests.
+	* Requests that specifically set {@link RequestInfo.cacheOptions.backgroundReload | cacheOptions.backgroundReload }
+	* will still be background reloaded in tests.
 	*
 	* This behavior can be opted out of by setting this value to `true`.
 	*
@@ -141,7 +193,7 @@ export interface PolicyConfig {
 	/**
 	* In addition to the simple time-based expiration strategy, CachePolicy
 	* supports various common server-supplied expiration strategies via
-	* headers, as well as custom expiration strategies via the `isExpired`
+	* headers, as well as custom expiration strategies via the {@link PolicyConfigConstraints.isExpired | isExpired}
 	* function.
 	*
 	* Requests will be validated for expiration against these constraints.
@@ -168,60 +220,9 @@ export interface PolicyConfig {
 	* -  ↳ (if null) Cache-Control header
 	* -  ↳ (if null) Expires header
 	*
+	* See {@link PolicyConfigConstraints} for configuration options.
 	*/
-	constraints?: {
-		/**
-		* Headers that should be checked for expiration.
-		*
-		*/
-		headers?: {
-			/**
-			* Whether the `Cache-Control` header should be checked for expiration.
-			* If `true`, then the `max-age` and `s-maxage` directives are used alongside
-			* the `Age` and `Date` headers to determine if the expiration time has passed.
-			*
-			* Other directives are ignored.
-			*
-			* 'Cache-Control' will take precedence over 'Expires' if both are present
-			* and both configured to be checked.
-			*
-			*/
-			"Cache-Control"?: boolean;
-			/**
-			* Whether the `Expires` header should be checked for expiration.
-			*
-			* If `true`, then the `Expires` header is used to caclulate the expiration time
-			* and determine if the expiration time has passed.
-			*
-			* 'Cache-Control' will take precedence over 'Expires' if both are present.
-			*
-			*/
-			Expires?: boolean;
-			/**
-			* Whether the `X-WarpDrive-Expires` header should be checked for expiration.
-			*
-			* If `true`, then the `X-WarpDrive-Expires` header is used to caclulate the expiration time
-			* and determine if the expiration time has passed.
-			*
-			* This header will take precedence over 'Cache-Control' and 'Expires' if all three are present.
-			*
-			* The header's value should be a [UTC date string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toUTCString).
-			*
-			*/
-			"X-WarpDrive-Expires"?: boolean;
-		};
-		/**
-		* A function that should be called to determine if the request is expired.
-		*
-		* If present, this function will be called with the request and should return
-		* `true` if the request is expired, `false` if it is not expired, and
-		* `null` if the expiration status is unknown.
-		*
-		* If the function does not return `null`,
-		*
-		*/
-		isExpired?: (request: StructuredDocument<ResourceDocument>) => boolean | null;
-	};
+	constraints?: PolicyConfigConstraints;
 }
 /**
 * A basic {@link CachePolicy} that can be added to the Store service.
@@ -257,8 +258,8 @@ export interface PolicyConfig {
 * add the `date` header to responses if it is not present.
 * :::
 *
-* - For manual override of reload see {@link RequestInfo.cacheOptions.reload | cacheOptions.reload}
-* - For manual override of background reload see {@link RequestInfo.cacheOptions.backgroundReload | cacheOptions.backgroundReload}
+* - For manual override of reload see {@link CacheOptions.reload | cacheOptions.reload}
+* - For manual override of background reload see {@link CacheOptions.backgroundReload | cacheOptions.backgroundReload}
 *
 * In order expiration is determined by:
 *
@@ -281,7 +282,7 @@ export interface PolicyConfig {
 * ### Automatic Invalidation / Entanglement
 *
 * It also invalidates any request with an {@link RequestInfo.op | OpCode} of `"query"`
-* for which {@link RequestInfo.cacheOptions.types | cacheOptions.types} was provided
+* for which {@link CacheOptions.types | cacheOptions.types} was provided
 * when a request with an `OpCode` of `"createRecord"` is successful and also includes
 * a matching type in its own `cacheOptions.types` array.
 
@@ -331,7 +332,7 @@ export declare class DefaultCachePolicy implements CachePolicy {
 	* of the store.
 	*
 	* This invalidation is done automatically when using this service
-	* for both the CacheHandler and the LegacyNetworkHandler.
+	* for both the {@link CacheHandler} and the [NetworkHandler](/api/@warp-drive/legacy/compat/variables/LegacyNetworkHandler).
 	*
 	* ```ts
 	* store.lifetimes.invalidateRequestsForType(store, 'person');
@@ -345,7 +346,7 @@ export declare class DefaultCachePolicy implements CachePolicy {
 	* This is invoked by the CacheHandler for both foreground and background requests
 	* once the cache has been updated.
 	*
-	* Note, this is invoked by the CacheHandler regardless of whether
+	* Note, this is invoked by the {@link CacheHandler} regardless of whether
 	* the request has a cache-key.
 	*
 	* This method should not be invoked directly by consumers.
@@ -357,7 +358,7 @@ export declare class DefaultCachePolicy implements CachePolicy {
 	* Invoked to determine if the request may be fulfilled from cache
 	* if possible.
 	*
-	* Note, this is only invoked by the CacheHandler if the request has
+	* Note, this is only invoked by the {@link CacheHandler} if the request has
 	* a cache-key.
 	*
 	* If no cache entry is found or the entry is hard expired,
@@ -372,7 +373,7 @@ export declare class DefaultCachePolicy implements CachePolicy {
 	* Invoked if `isHardExpired` is false to determine if the request
 	* should be update behind the scenes if cache data is already available.
 	*
-	* Note, this is only invoked by the CacheHandler if the request has
+	* Note, this is only invoked by the {@link CacheHandler} if the request has
 	* a cache-key.
 	*
 	* If true, the request will be fulfilled from cache while a backgrounded

package/declarations/store/-private/managers/cache-capabilities-manager.d.ts

@@ -1,6 +1,6 @@
 import type { RequestKey, ResourceKey } from "../../../types/identifier.js";
-import type { CacheCapabilitiesManager as StoreWrapper } from "../../-types/q/cache-capabilities-manager.js";
 import type { SchemaService } from "../../../types/schema/schema-service.js";
+import type { CacheCapabilitiesManager as StoreWrapper } from "../../-types/q/cache-capabilities-manager.js";
 import type { PrivateStore, Store } from "../store-service.js";
 import type { CacheKeyManager } from "./cache-key-manager.js";
 import type { NotificationType } from "./notification-manager.js";

package/declarations/store/-private/managers/cache-manager.d.ts

@@ -6,7 +6,7 @@ import type { LocalRelationshipOperation } from "../../../types/graph.js";
 import type { RequestKey, ResourceKey } from "../../../types/identifier.js";
 import type { Value } from "../../../types/json/raw.js";
 import type { StructuredDataDocument, StructuredDocument } from "../../../types/request.js";
-import type { ResourceDocument, SingleResourceDataDocument } from "../../../types/spec/document.js";
+import type { CollectionResourceDataDocument, ResourceDocument, SingleResourceDataDocument } from "../../../types/spec/document.js";
 import type { ApiError } from "../../../types/spec/error.js";
 import type { StoreRequestContext } from "../cache-handler/handler.js";
 /**
@@ -220,21 +220,23 @@ export declare class CacheManager implements Cache {
 	* @public
 	* @param key
 	*/
-	willCommit(key: ResourceKey, context: StoreRequestContext): void;
+	willCommit(key: ResourceKey | ResourceKey[], context: StoreRequestContext): void;
 	/**
 	* [LIFECYCLE] Signals to the cache that a resource
 	* was successfully updated as part of a save transaction.
 	*
 	* @public
 	*/
-	didCommit(key: ResourceKey, result: StructuredDataDocument<unknown>): SingleResourceDataDocument;
+	didCommit(key: ResourceKey, result: StructuredDataDocument<SingleResourceDataDocument> | null): SingleResourceDataDocument;
+	didCommit(key: ResourceKey[], result: StructuredDataDocument<SingleResourceDataDocument> | null): SingleResourceDataDocument;
+	didCommit(key: ResourceKey[], result: StructuredDataDocument<CollectionResourceDataDocument> | null): CollectionResourceDataDocument;
 	/**
 	* [LIFECYCLE] Signals to the cache that a resource
 	* was update via a save transaction failed.
 	*
 	* @public
 	*/
-	commitWasRejected(key: ResourceKey, errors?: ApiError[]): void;
+	commitWasRejected(key: ResourceKey | ResourceKey[], errors?: ApiError[]): void;
 	/**
 	* [LIFECYCLE] Signals to the cache that all data for a resource
 	* should be cleared.

package/declarations/store/-private/new-core-tmp/promise-state.d.ts

@@ -256,6 +256,7 @@ export declare function createPromiseState<
 *
 * If looking to use in a template, consider also the `<Await />` component.
 *
+* See also {@link PromiseState}
 */
 export declare function getPromiseState<
 	T = unknown,

package/declarations/store/-private/store-service.d.ts

@@ -4,11 +4,11 @@ import type { PrivateRequestManager, RequestManager } from "../../request/-priva
 import type { Cache } from "../../types/cache.js";
 import type { PersistedResourceKey, ResourceKey } from "../../types/identifier.js";
 import type { TypedRecordInstance, TypeFromInstance } from "../../types/record.js";
+import type { SchemaService } from "../../types/schema/schema-service.js";
 import type { CollectionResourceDocument, EmptyResourceDocument, JsonApiDocument, ResourceIdentifierObject, SingleResourceDocument } from "../../types/spec/json-api-raw.js";
 import type { Type } from "../../types/symbols.js";
 import type { CacheCapabilitiesManager } from "../-types/q/cache-capabilities-manager.js";
 import type { OpaqueRecordInstance } from "../-types/q/record-instance.js";
-import type { SchemaService } from "../../types/schema/schema-service.js";
 import type { StoreRequestInput } from "./cache-handler/handler.js";
 import type { CachePolicy } from "./cache-handler/types.js";
 import { InstanceCache, storeFor } from "./caches/instance-cache.js";

package/declarations/store/-types/q/cache-capabilities-manager.d.ts

@@ -1,7 +1,7 @@
 import type { RequestKey, ResourceKey } from "../../../types/identifier.js";
+import type { SchemaService } from "../../../types/schema/schema-service.js";
 import type { CacheKeyManager } from "../../-private/managers/cache-key-manager.js";
 import type { NotificationType } from "../../-private/managers/notification-manager.js";
-import type { SchemaService } from "../../../types/schema/schema-service.js";
 /**
 * CacheCapabilitiesManager provides encapsulated API access to the minimal
 * subset of the Store's functionality that Cache implementations

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

@@ -254,7 +254,7 @@ declare module "../-private/store-service" {
 		
 		If you use an adapter such as the
 		[JSONAPIAdapter](/api/@warp-drive/legacy/adapter/json-api/classes/JSONAPIAdapter)
-		which supports the [{JSON:API} specification](http://jsonapi.org/) and if your server
+		which supports the [{json:api} specification](http://jsonapi.org/) and if your server
 		endpoint supports the use of an
 		['include' query parameter](http://jsonapi.org/format/#fetching-includes),
 		you can use `findRecord()` or `findAll()` to automatically retrieve additional records related to