@warp-drive/core 5.8.0-alpha.4 → 5.8.0-alpha.41

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

@@ -1,5 +1,5 @@
 import { type PersistedResourceKey, type RequestKey, type ResourceKey } from "../../../types/identifier.js";
-import type { ImmutableRequestInfo } from "../../../types/request.js";
+import type { RequestInfo } from "../../../types/request.js";
 import type { ExistingResourceIdentifierObject, ResourceIdentifierObject } from "../../../types/spec/json-api-raw.js";
 import type { ForgetMethod, GenerationMethod, KeyInfo, KeyInfoMethod, ResetMethod, UpdateMethod } from "../../-types/q/identifier.js";
 type TypeFromIdentifier<T> = T extends {
@@ -197,16 +197,34 @@ export declare class CacheKeyManager {
 	*
 	* @private
 	*/
-	peekRecordIdentifier(resource: ResourceIdentifierObject): ResourceKey | undefined;
+	peekResourceKey(resource: ResourceIdentifierObject): ResourceKey | undefined;
 	/**
-	Returns the DocumentIdentifier for the given Request, creates one if it does not yet exist.
-	Returns `null` if the request does not have a `cacheKey` or `url`.
-	
-	@public
+	* 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: ImmutableRequestInfo): RequestKey | null;
+	getOrCreateDocumentIdentifier(request: RequestInfo): RequestKey | null;
 	/**
-	Returns the Identifier for the given Resource, creates one if it does not yet exist.
+	Returns the {@link ResourceKey} for the given Resource, creates one if it does not yet exist.
 	
 	Specifically this means that we:
 	

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";
 /**
@@ -48,8 +48,6 @@ export declare class CacheManager implements Cache {
 	* a `content` member and therefor must not assume the existence
 	* of `request` and `response` on the document.
 	*
-	* @param {StructuredDocument} doc
-	* @return {ResourceDocument}
 	* @public
 	*/
 	put<T>(doc: StructuredDocument<T> | {
@@ -60,7 +58,6 @@ export declare class CacheManager implements Cache {
 	*
 	* @public
 	* @param op the operation to perform
-	* @return {void}
 	*/
 	patch(op: Operation | Operation[]): void;
 	/**
@@ -68,7 +65,6 @@ export declare class CacheManager implements Cache {
 	* on relationships only.
 	*
 	* @public
-	* @param mutation
 	*/
 	mutate(mutation: LocalRelationshipOperation): void;
 	/**
@@ -99,8 +95,7 @@ export declare class CacheManager implements Cache {
 	* notifications for relational data.
 	*
 	* @public
-	* @param {ResourceKey | RequestKey} cacheKey
-	* @return {ResourceDocument | ResourceBlob | null} the known resource data
+	* @return the known resource data
 	*/
 	peek(cacheKey: ResourceKey): unknown;
 	peek(cacheKey: RequestKey): ResourceDocument | null;
@@ -110,8 +105,6 @@ export declare class CacheManager implements Cache {
 	* Peek the Cache for the existing request data associated with
 	* a cacheable request
 	*
-	* @param {RequestKey}
-	* @return {RequestKey | null}
 	* @public
 	*/
 	peekRequest(key: RequestKey): StructuredDocument<ResourceDocument> | null;
@@ -130,7 +123,6 @@ export declare class CacheManager implements Cache {
 	* utilize this method to fork the cache.
 	*
 	* @public
-	* @return {Promise<Cache>}
 	*/
 	fork(): Promise<Cache>;
 	/**
@@ -140,9 +132,7 @@ export declare class CacheManager implements Cache {
 	* preferring instead to merge at the Store level, which will
 	* utilize this method to merge the caches.
 	*
-	* @param {Cache} cache
 	* @public
-	* @return {Promise<void>}
 	*/
 	merge(cache: Cache): Promise<void>;
 	/**
@@ -183,7 +173,6 @@ export declare class CacheManager implements Cache {
 	* which may be fed back into a new instance of the same Cache
 	* via `cache.hydrate`.
 	*
-	* @return {Promise<ReadableStream>}
 	* @public
 	*/
 	dump(): Promise<ReadableStream<unknown>>;
@@ -199,8 +188,6 @@ export declare class CacheManager implements Cache {
 	* behavior supports optimizing pre/fetching of data for route transitions
 	* via data-only SSR modes.
 	*
-	* @param {ReadableStream} stream
-	* @return {Promise<void>}
 	* @public
 	*/
 	hydrate(stream: ReadableStream<unknown>): Promise<void>;
@@ -220,21 +207,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/managers/notification-manager.d.ts

@@ -25,7 +25,7 @@ export interface DocumentOperationCallback {
 * @hideconstructor
 * @public
 */
-export default class NotificationManager {
+export declare class NotificationManager {
 	constructor(store: Store);
 	/**
 	* Subscribe to changes for a given ResourceKey, RequestKey, or addition/removal of any resource

package/declarations/store/-private/record-arrays/legacy-many-array.d.ts

@@ -16,7 +16,7 @@ This class is not intended to be directly instantiated by consuming applications
 
 ### Inverses
 
-Often, the relationships in Ember Data applications will have
+Often, the relationships in WarpDrive applications will have
 an inverse. For example, imagine the following models are
 defined:
 

package/declarations/store/-private/record-arrays/resource-array.d.ts

@@ -1,9 +1,9 @@
 import type { ExtensionDef } from "../../../reactive.js";
 import { Context } from "../../../reactive/-private.js";
+import type { SignalStore, WarpDriveSignal } from "../../../signals/-private.js";
 import type { RequestKey, ResourceKey } from "../../../types/identifier.js";
 import type { ObjectValue } from "../../../types/json/raw.js";
 import type { CollectionField } from "../../../types/schema/fields.js";
-import type { SignalStore, WarpDriveSignal } from "../new-core-tmp/reactivity/internal.js";
 import type { Store } from "../store-service.js";
 import type { KeyType, MinimumManager } from "./-utils.js";
 import { NativeProxy } from "./native-proxy-type-fix.js";

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

@@ -4,18 +4,18 @@ 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/q/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";
 import type { PrivateCacheKeyManager } from "./managers/cache-key-manager.js";
 import { CacheKeyManager } from "./managers/cache-key-manager.js";
 import type { PrivateNotificationManager } from "./managers/notification-manager.js";
-import NotificationManager from "./managers/notification-manager.js";
+import { NotificationManager } from "./managers/notification-manager.js";
 import type { PrivateRecordArrayManager } from "./managers/record-array-manager.js";
 import type { PrivateRequestStateService } from "./network/request-cache.js";
 import { RequestStateService } from "./network/request-cache.js";
@@ -101,7 +101,7 @@ export interface Store {
 	* For Example, to use the default SchemaService for ReactiveResource
 	*
 	* ```ts
-	* import { SchemaService } from '@warp-drive/schema-record';
+	* import { SchemaService } from '@warp-drive/core/reactive';
 	*
 	* class extends Store {
 	*   createSchemaService() {
@@ -110,10 +110,10 @@ export interface Store {
 	* }
 	* ```
 	*
-	* Or to use the SchemaService for @ember-data/model
+	* Or to use the SchemaService for @warp-drive/legacy/model
 	*
 	* ```ts
-	* import { buildSchema } from '@ember-data/model';
+	* import { buildSchema } from '@warp-drive/legacy/model';
 	*
 	* class extends Store {
 	*   createSchemaService() {
@@ -125,13 +125,13 @@ export interface Store {
 	* If you wish to chain services, you must either
 	* instantiate each schema source directly or super to retrieve
 	* an existing service. For convenience, when migrating from
-	* `@ember-data/model` to `@warp-drive/schema-record` a
+	* `@warp-drive/legacy/model` to {@link ReactiveResource} a
 	* SchemaService is provided that handles this transition
 	* for you:
 	*
 	* ```ts
-	* import { DelegatingSchemaService } from '@ember-data/model/migration-support';
-	* import { SchemaService } from '@warp-drive/schema-record';
+	* import { DelegatingSchemaService } from '@warp-drive/legacy/model/migration-support';
+	* import { SchemaService } from '@warp-drive/core/reactive';
 	*
 	* class extends Store {
 	*   createSchemaService() {
@@ -176,7 +176,7 @@ export interface Store {
 	* For Example:
 	*
 	* ```ts
-	* import Store from '@ember-data/store';
+	* import { Store } from '@warp-drive/core';
 	*
 	* class SchemaDelegator {
 	*   constructor(schema) {
@@ -210,7 +210,6 @@ export interface Store {
 	* }
 	* ```
 	*
-	* @param {SchemaService} schema
 	* @deprecated
 	* @public
 	*/
@@ -230,7 +229,7 @@ export interface Store {
 	* For Example:
 	*
 	* ```ts
-	* import Store from '@ember-data/store';
+	* import { Store } from '@warp-drive/core';
 	*
 	* class SchemaDelegator {
 	*   constructor(schema) {
@@ -264,7 +263,6 @@ export interface Store {
 	* }
 	* ```
 	*
-	* @param {SchemaService} schema
 	* @deprecated
 	* @public
 	*/
@@ -290,7 +288,7 @@ export interface Store {
 */
 export declare class Store extends BaseClass {
 	/**
-	* Provides access to the NotificationManager associated
+	* Provides access to the {@link NotificationManager} associated
 	* with this Store instance.
 	*
 	* The NotificationManager can be used to subscribe to
@@ -321,20 +319,18 @@ export declare class Store extends BaseClass {
 	*/
 	readonly cacheKeyManager: CacheKeyManager;
 	/**
-	* Provides access to the requestManager instance associated
+	* Provides access to the {@link RequestManager} instance associated
 	* with this Store instance.
 	*
-	* When using `ember-data` this property is automatically
-	* set to an instance of `RequestManager`. When not using `ember-data`
-	* you must configure this property yourself, either by declaring
-	* it as a service or by initializing it.
+	* See also:
+	* - {@link Fetch}
+	* - {@link CacheHandlerInterface | CacheHandler (Interface)}
+	* - {@link CacheHandler | CacheHandler (Class)}
 	*
 	* ```ts
-	* import Store, { CacheHandler } from '@ember-data/store';
-	* import RequestManager from '@ember-data/request';
-	* import Fetch from '@ember-data/request/fetch';
+	* import { CacheHandler, Fetch, RequestManager, Store } from '@warp-drive/core';
 	*
-	* class extends Store {
+	* class AppStore extends Store {
 	*   requestManager = new RequestManager()
 	*    .use([Fetch])
 	*    .useCache(CacheHandler);
@@ -350,9 +346,9 @@ export declare class Store extends BaseClass {
 	*
 	* Note, when defined, these methods will only be invoked if a
 	* cache key exists for the request, either because the request
-	* contains `cacheOptions.key` or because the [CacheKeyManager](/ember-data/release/classes/CacheKeyManager)
+	* contains `cacheOptions.key` or because the {@link CacheKeyManager}
 	* was able to generate a key for the request using the configured
-	* [generation method](/ember-data/release/functions/@ember-data%2Fstore/setIdentifierGenerationMethod).
+	* {@link setIdentifierGenerationMethod | generation method}.
 	*
 	* `isSoftExpired` will only be invoked if `isHardExpired` returns `false`.
 	*
@@ -557,14 +553,10 @@ export declare class Store extends BaseClass {
 	otherwise it will return `null`. A record is available if it has been fetched earlier, or
 	pushed manually into the store.
 	
-	See [findRecord](../methods/findRecord?anchor=findRecord) if you would like to request this record from the backend.
-	
-	_Note: This is a synchronous method and does not return a promise._
-	
 	**Example 1**
 	
-	```js
-	let post = store.peekRecord('post', '1');
+	```ts
+	const post = store.peekRecord('post', '1');
 	
 	post.id; // '1'
 	```
@@ -575,8 +567,8 @@ export declare class Store extends BaseClass {
 	
 	**Example 2**
 	
-	```js
-	let post = store.peekRecord({ type: 'post', id });
+	```ts
+	const post = store.peekRecord({ type: 'post', id: '1' });
 	post.id; // '1'
 	```
 	
@@ -590,40 +582,34 @@ export declare class Store extends BaseClass {
 	post.id; // '1'
 	```
 	
-	
 	@since 1.13.0
 	@public
-	@param {String|object} modelName - either a string representing the modelName or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record
-	@param {String|Integer} id - optional only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved.
-	@return {Model|null} record
+	@param type - either a string representing the modelName or a ResourceIdentifier object containing both the type (a string) and the id (a string) for the record or an lid (a string) of an existing record
+	@param id - optional only if the first param is a ResourceIdentifier, else the string id of the record to be retrieved.
 	*/
 	peekRecord<T>(type: TypeFromInstance<T>, id: string | number): T | null;
 	peekRecord(type: string, id: string | number): unknown | null;
 	peekRecord<T>(identifier: ResourceIdentifierObject<TypeFromInstance<T>>): T | null;
 	peekRecord(identifier: ResourceIdentifierObject): unknown | null;
 	/**
-	This method returns a filtered array that contains all of the
-	known records for a given type in the store.
+	This method returns the {@link LegacyLiveArray} that contains all of the
+	known records for a given type in the store. Each ResourceType has only
+	one LiveArray instance, so multiple calls to `peekAll` with the same type
+	will always return the same instance.
 	
-	Note that because it's just a filter, the result will contain any
+	Note that because it's a LiveArray, the result will contain any
 	locally created records of the type, however, it will not make a
-	request to the backend to retrieve additional records. If you
-	would like to request all the records from the backend please use
-	[store.findAll](../methods/findAll?anchor=findAll).
-	
-	Also note that multiple calls to `peekAll` for a given type will always
-	return the same `RecordArray`.
+	request to the backend to retrieve additional records.
 	
 	Example
 	
-	```javascript
-	let localPosts = store.peekAll('post');
+	```ts
+	const allPosts = store.peekAll('post');
 	```
 	
 	@since 1.13.0
 	@public
-	@param {String} type the name of the resource
-	@return {RecordArray}
+	@param type the name of the resource
 	*/
 	peekAll<T>(type: TypeFromInstance<T>): LegacyLiveArray<T>;
 	peekAll(type: string): LegacyLiveArray;
@@ -708,7 +694,7 @@ export declare class Store extends BaseClass {
 	For this model:
 	
 	```js [app/models/person.js]
-	import Model, { attr, hasMany } from '@ember-data/model';
+	import Model, { attr, hasMany } from '@warp-drive/legacy/model';
 	
 	export default class PersonRoute extends Route {
 	@attr('string') firstName;
@@ -775,23 +761,17 @@ export declare class Store extends BaseClass {
 	}
 	```
 	
-	If you're streaming data or implementing an adapter, make sure
-	that you have converted the incoming data into this form. The
-	store's [normalize](../methods/normalize?anchor=normalize) method is a convenience
-	helper for converting a json payload into the form Ember Data
-	expects.
-	
-	```js
-	store.push(store.normalize('person', data));
-	```
+	If you're streaming data, or implementing response handling, make sure
+	that you have converted the incoming data into this form.
 	
 	This method can be used both to push in brand new
 	records, as well as to update existing records.
 	
+	See also {@link Cache.patch}
+	
 	@public
-	@param {Object} data
-	@return the record(s) that was created or
-	updated.
+	@param data
+	@return the primary record(s) that created or updated.
 	*/
 	push(data: EmptyResourceDocument): null;
 	push<T>(data: SingleResourceDocument<TypeFromInstance<T>>): T;
@@ -803,8 +783,7 @@ export declare class Store extends BaseClass {
 	without creating materialized records.
 	
 	@private
-	@param {Object} jsonApiDoc
-	@return {ResourceKey|Array<ResourceKey>|null} identifiers for the primary records that had data loaded
+	@return identifiers for the primary records that had data loaded
 	*/
 	_push(jsonApiDoc: JsonApiDocument, asyncFlush?: boolean): PersistedResourceKey | PersistedResourceKey[] | null;
 	/**

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

@@ -22,9 +22,3 @@ export { normalizeModelName as _deprecatingNormalize } from "./-private/utils/no
 export type { StoreRequestInput } from "./-private/cache-handler/handler.js";
 export { type LegacyManyArray, type LegacyManyArray as RelatedCollection, createLegacyManyArray } from "./-private/record-arrays/legacy-many-array.js";
 export { log, logGroup } from "./-private/debug/utils.js";
-export { getPromiseState, type PromiseState } from "./-private/new-core-tmp/promise-state.js";
-export { DISPOSE, createRequestSubscription, type RequestArgs, type SubscriptionArgs, type RequestComponentArgs, type RequestSubscription, type ContentFeatures, type RecoveryFeatures, type AutorefreshBehaviorCombos, type AutorefreshBehaviorType } from "./-private/new-core-tmp/request-subscription.js";
-export { getRequestState, type RequestLoadingState, type RequestCacheRequestState as RequestState } from "./-private/new-core-tmp/request-state.js";
-export { type SignalHooks, waitFor } from "./-private/new-core-tmp/reactivity/configure.js";
-export { signal, memoized, gate, entangleSignal, entangleInitiallyStaleSignal, defineSignal, defineGate, defineNonEnumerableSignal } from "./-private/new-core-tmp/reactivity/signal.js";
-export { ARRAY_SIGNAL, OBJECT_SIGNAL, Signals, type WarpDriveSignal, peekInternalSignal, createInternalMemo, withSignalStore, notifyInternalSignal, consumeInternalSignal, getOrCreateInternalSignal } from "./-private/new-core-tmp/reactivity/internal.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 "./schema-service.js";
 /**
 * CacheCapabilitiesManager provides encapsulated API access to the minimal
 * subset of the Store's functionality that Cache implementations

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

@@ -42,7 +42,7 @@ export type KeyOrString<T> = keyof T & string extends never ? string : keyof T &
 * "model" class.
 *
 * Only used when using the legacy schema-service implementation
-* for @ember-data/model or when wrapping schema for legacy
+* for @warp-drive/legacy/model or when wrapping schema for legacy
 * Adapters/Serializers.
 *
 */
@@ -124,7 +124,7 @@ export declare class RecordReference {
 	normalized hash of data and the object represented by the reference
 	will update.
 	
-	If you pass a promise to `push`, Ember Data will not ask the adapter
+	If you pass a promise to `push`, WarpDrive will not ask the adapter
 	for the data if another attempt to fetch it is made in the
 	interim. When the promise resolves, the underlying object is updated
 	with the new data, and the promise returned by *this function* is resolved

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

@@ -248,13 +248,13 @@ declare module "../-private/store-service" {
 		}
 		```
 		
-		See [peekRecord](../methods/peekRecord?anchor=peekRecord) to get the cached version of a record.
+		See {@link Store.peekRecord | peekRecord} to get the cached version of a record.
 		
 		### Retrieving Related Model Records
 		
-		If you use an adapter such as Ember's default
-		[`JSONAPIAdapter`](/ember-data/release/classes/JSONAPIAdapter)
-		that supports the [JSON API specification](http://jsonapi.org/) and if your server
+		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
 		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
@@ -421,7 +421,7 @@ declare module "../-private/store-service" {
 		records in the store:
 		
 		```js [app/adapters/application.js]
-		import Adapter from '@ember-data/adapter';
+		import { Adapter } from '@warp-drive/legacy/adapter';
 		
 		export default class ApplicationAdapter extends Adapter {
 		shouldReloadAll(store, snapshotsArray) {
@@ -498,13 +498,13 @@ declare module "../-private/store-service" {
 		}
 		```
 		
-		See [peekAll](../methods/peekAll?anchor=peekAll) to get an array of current records in the
+		See {@link Store.peekAll | peekAll} to get an array of current records in the
 		store, without waiting until a reload is finished.
 		
 		### Retrieving Related Model Records
 		
-		If you use an adapter such as Ember's default
-		[`JSONAPIAdapter`](/ember-data/release/classes/JSONAPIAdapter)
+		If you use an adapter such as the default
+		[JSONAPIAdapter](/api/@warp-drive/legacy/adapter/json-api/classes/JSONAPIAdapter)
 		that 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),
@@ -535,7 +535,7 @@ declare module "../-private/store-service" {
 		}
 		```
 		
-		See [query](../methods/query?anchor=query) to only get a subset of records from the server.
+		See {@link Store.query | query} to only get a subset of records from the server.
 		
 		@public
 		@deprecated use {@link Store.request} instead
@@ -575,7 +575,7 @@ declare module "../-private/store-service" {
 		
 		If you do something like this:
 		
-		```javascript
+		```js
 		store.query('person', { ids: ['1', '2', '3'] });
 		```
 		
@@ -602,7 +602,7 @@ declare module "../-private/store-service" {
 		query(type: string, query: LegacyResourceQuery, options?: QueryOptions): Promise<LegacyQueryArray>;
 		/**
 		This method makes a request for one record, where the `id` is not known
-		beforehand (if the `id` is known, use [`findRecord`](../methods/findRecord?anchor=findRecord)
+		beforehand (if the `id` is known, use {@link Store.findRecord | findRecord}
 		instead).
 		
 		This method can be used when it is certain that the server will return a
@@ -611,37 +611,40 @@ declare module "../-private/store-service" {
 		Each time this method is called a new request is made through the adapter.
 		
 		Let's assume our API provides an endpoint for the currently logged in user
-		via:
 		
-		```
-		// GET /api/current_user
+		```ts
+		// GET /api/user/me
 		{
-		user: {
-		id: 1234,
+		data: {
+		type: 'user',
+		id: '1234',
+		attributes: {
 		username: 'admin'
 		}
 		}
+		}
 		```
 		
 		Since the specific `id` of the `user` is not known beforehand, we can use
 		`queryRecord` to get the user:
 		
-		```javascript
-		store.queryRecord('user', {}).then(function(user) {
-		let username = user.username;
-		// do thing
-		});
+		```ts
+		const user = await store.queryRecord('user', { me: true });
+		user.username; // admin
 		```
 		
 		The request is made through the adapters' `queryRecord`:
 		
-		```js [app/adapters/user.js]
-		import Adapter from '@ember-data/adapter';
-		import $ from 'jquery';
+		```ts [app/adapters/user.ts]
+		import Adapter from '@warp-drive/legacy/adapter';
 		
 		export default class UserAdapter extends Adapter {
-		queryRecord(modelName, query) {
-		return $.getJSON('/api/current_user');
+		async queryRecord(modelName, query) {
+		if (query.me) {
+		const response = await fetch('/api/me');
+		return await response.json();
+		}
+		throw new Error('Unsupported query');
 		}
 		}
 		```
@@ -664,7 +667,7 @@ declare module "../-private/store-service" {
 		}
 		```
 		
-		```javascript
+		```js
 		store.query('user', { username: 'unique' }).then(function(users) {
 		return users.firstObject;
 		}).then(function(user) {
@@ -684,7 +687,7 @@ declare module "../-private/store-service" {
 		}
 		```
 		
-		```javascript
+		```js
 		store.queryRecord('user', { username: 'unique' }).then(function(user) {
 		// user is null
 		});
@@ -744,7 +747,7 @@ declare module "../-private/store-service" {
 		/**
 		Returns the schema for a particular resource type (modelName).
 		
-		When used with Model from @ember-data/model the return is the model class,
+		When used with [Model](/api/@warp-drive/legacy/model/classes/Model) the return is the model class,
 		but this is not guaranteed.
 		
 		If looking to query attribute or relationship information it is
@@ -754,9 +757,7 @@ declare module "../-private/store-service" {
 		signatures.
 		
 		The class of a model might be useful if you want to get a list of all the
-		relationship names of the model, see
-		[`relationshipNames`](/ember-data/release/classes/Model?anchor=relationshipNames)
-		for example.
+		relationship names of the model.
 		
 		@public
 		@deprecated use {@link Store.schema} instead