@warp-drive/legacy 5.8.0-alpha.9 → 5.8.0-beta.1

package/declarations/serializer.d.ts

@@ -14,14 +14,14 @@ needs to understand the structure of data it receives.
 the format WarpDrive understands.
 
 Data received from an API response is **normalized** into
-[JSON:API](https://jsonapi.org/) (the format used internally
+[{json:api}](https://jsonapi.org/) (the format used internally
 by WarpDrive), while data sent to an API is **serialized**
 into the format the API expects.
 
 ### Implementing a Serializer
 
 There are only two required serializer methods, one for
-normalizing data from the server API format into JSON:API, and
+normalizing data from the server API format into {json:api}, and
 another for serializing records via `Snapshots` into the expected
 server API format.
 
@@ -67,7 +67,7 @@ store.serializerFor('author');
 //   app/serializers/application.js
 ```
 
-Most requests in @warp-drive/legacy are made with respect to a particular `type` (or `modelName`)
+Most requests in `@warp-drive/legacy` are made with respect to a particular `type` (or `modelName`)
 (e.g., "get me the full collection of **books**" or "get me the **employee** whose id is 37"). We
 refer to this as the **primary** resource `type`.
 
@@ -91,7 +91,7 @@ Any serializer in `app/serializers/` can be looked up by `name` using `store.ser
 ### Default Serializers
 
 For applications whose APIs are *very close to* or *exactly* the **REST** format or **JSON:API**
-format the `@ember-data/serializer` package contains implementations these applications can
+format the `@warp-drive/legacy/serializer` package contains implementations these applications can
 extend. It also contains a simple `JSONSerializer` for serializing to/from very basic JSON objects.
 
 Many applications will find writing their own serializer to be more performant and less
@@ -122,8 +122,7 @@ And you can optionally override the following methods:
 
 * `normalize()`
 
-For an example implementation, see
-[JSONSerializer](JSONSerializer), the included JSON serializer.
+For an example implementation, see the included {@link JSONSerializer}.
 
 @class Serializer
 @public

package/dist/{-private-B1pSSN52.js → -private-BG3bMiKp.js}

@@ -1,7 +1,8 @@
 import { Context } from '@warp-drive/core/reactive/-private';
 import { warn } from '@ember/debug';
 import { createDeferred } from '@warp-drive/core/request';
-import { assertPrivateStore, waitFor, coerceId } from '@warp-drive/core/store/-private';
+import { waitFor } from '@warp-drive/core/signals/-leaked';
+import { assertPrivateStore, coerceId } from '@warp-drive/core/store/-private';
 import { getOrSetGlobal } from '@warp-drive/core/types/-private';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 

package/dist/adapter/-private.js

@@ -1 +1 @@
-export { d as determineBodyPromise, g as fetch, p as parseResponseHeaders, b as serializeIntoHash, s as serializeQueryParams, a as setupFastboot } from "../serialize-into-hash-BnYvPex3.js";
+export { d as determineBodyPromise, g as fetch, p as parseResponseHeaders, b as serializeIntoHash, s as serializeQueryParams, a as setupFastboot } from "../serialize-into-hash-DPZYoF-i.js";

package/dist/adapter/error.js

@@ -24,7 +24,7 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
   it was closed for maintenance:
 
   ```js [app/adapters/maintenance-error.js]
-  import AdapterError from '@ember-data/adapter/error';
+  import AdapterError from '@warp-drive/legacy/adapter/error';
 
   export default AdapterError.extend({ message: "Down for maintenance." });
   ```
@@ -32,7 +32,7 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
   This error would then be returned by an adapter's `handleResponse` method:
 
   ```js [app/adapters/application.js]
-  import JSONAPIAdapter from '@ember-data/adapter/json-api';
+  import JSONAPIAdapter from '@warp-drive/legacy/adapter/json-api';
   import MaintenanceError from './maintenance-error';
 
   export default class ApplicationAdapter extends JSONAPIAdapter {
@@ -125,8 +125,8 @@ function extend(ParentErrorClass, defaultMessage) {
   transition to the `invalid` state and the errors will be set to the
   `errors` property on the record.
 
-  For Ember Data to correctly map errors to their corresponding
-  properties on the model, Ember Data expects each error to be
+  For WarpDrive to correctly map errors to their corresponding
+  properties on the model, WarpDrive expects each error to be
   a valid JSON-API error object with a `source/pointer` that matches
   the property name. For example, if you had a Post model that
   looked like this.
@@ -146,8 +146,8 @@ function extend(ParentErrorClass, defaultMessage) {
 
   ```js [app/adapters/post.js]
   import RSVP from 'RSVP';
-  import RESTAdapter from '@ember-data/adapter/rest';
-  import { InvalidError } from '@ember-data/adapter/error';
+  import RESTAdapter from '@warp-drive/legacy/adapter/rest';
+  import { InvalidError } from '@warp-drive/legacy/adapter/error';
 
   export default class ApplicationAdapter extends RESTAdapter {
     updateRecord() {
@@ -189,7 +189,7 @@ InvalidError.prototype.code = 'InvalidError';
   connection if an adapter operation has timed out:
 
   ```js [app/routes/application.js]
-  import { TimeoutError } from '@ember-data/adapter/error';
+  import { TimeoutError } from '@warp-drive/legacy/adapter/error';
 
   export default class ApplicationRoute extends Route {
     @action
@@ -235,7 +235,7 @@ AbortError.prototype.code = 'AbortError';
   request is unauthorized:
 
   ```js [app/routes/application.js]
-  import { UnauthorizedError } from '@ember-data/adapter/error';
+  import { UnauthorizedError } from '@warp-drive/legacy/adapter/error';
 
   export default class ApplicationRoute extends Route {
     @action
@@ -281,7 +281,7 @@ ForbiddenError.prototype.code = 'ForbiddenError';
   for a specific model that does not exist. For example:
 
   ```js [app/routes/post.js]
-  import { NotFoundError } from '@ember-data/adapter/error';
+  import { NotFoundError } from '@warp-drive/legacy/adapter/error';
 
   export default class PostRoute extends Route {
     @service store;

package/dist/adapter/json-api.js

@@ -1,7 +1,7 @@
 import { dasherize, pluralize } from '@warp-drive/utilities/string';
 import '@ember/debug';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
-import { b as serializeIntoHash } from "../serialize-into-hash-BnYvPex3.js";
+import { b as serializeIntoHash } from "../serialize-into-hash-DPZYoF-i.js";
 import { RESTAdapter } from './rest.js';
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars

package/dist/adapter/rest.js

@@ -2,7 +2,7 @@ import { getOwner } from '@ember/application';
 import { warn } from '@ember/debug';
 import { computed } from '@ember/object';
 import { Adapter, BuildURLMixin } from '../adapter.js';
-import { b as serializeIntoHash, d as determineBodyPromise, g as getFetchFunction, s as serializeQueryParams, p as parseResponseHeaders } from "../serialize-into-hash-BnYvPex3.js";
+import { b as serializeIntoHash, d as determineBodyPromise, g as getFetchFunction, s as serializeQueryParams, p as parseResponseHeaders } from "../serialize-into-hash-DPZYoF-i.js";
 import { InvalidError, ServerError, ConflictError, NotFoundError, ForbiddenError, UnauthorizedError, AdapterError, TimeoutError, AbortError } from './error.js';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import { d as decorateMethodV2 } from "../runtime-BPCpkOf1-BKOwiRJp.js";
@@ -89,7 +89,7 @@ const AdapterWithBuildURLMixin = Adapter.extend(BuildURLMixin);
   Note that the object root can be pluralized for both a single-object response
   and an array response: the REST adapter is not strict on this. Further, if the
   HTTP server responds to a `GET` request to `/posts/1` (e.g. the response to a
-  `findRecord` query) with more than one object in the array, Ember Data will
+  `findRecord` query) with more than one object in the array, WarpDrive will
   only display the object with the matching ID.
 
   ### Conventional Names
@@ -150,7 +150,7 @@ const AdapterWithBuildURLMixin = Adapter.extend(BuildURLMixin);
 
   If the records in the relationship are not known when the response
   is serialized it's also possible to represent the relationship as a
-  URL using the `links` key in the response. Ember Data will fetch
+  URL using the `links` key in the response. WarpDrive will fetch
   this URL to resolve the relationship when it is accessed for the
   first time.
 
@@ -233,17 +233,12 @@ const AdapterWithBuildURLMixin = Adapter.extend(BuildURLMixin);
   }
   ```
 
-  @class RESTAdapter
   @public
-  @constructor
-  @uses BuildURLMixin
 */
 class RESTAdapter extends AdapterWithBuildURLMixin {
   /**
     This property allows ajax to still be used instead when `false`.
-     @property useFetch
-    @type {Boolean}
-    @default true
+     @default true
     @public
   */
   useFetch = true;
@@ -291,9 +286,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
       }
     }
     ```
-     @param {Object} obj
-    @return {Object}
-    @public
+     @public
   */
   sortQueryParams(obj) {
     const keys = Object.keys(obj);
@@ -342,9 +335,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      will also send a request to: `GET /comments?ids[]=1&ids[]=2`
      Note: Requests coalescing rely on URL building strategy. So if you override `buildURL` in your app
     `groupRecordsForFindMany` more likely should be overridden as well in order for coalescing to work.
-     @property coalesceFindRequests
-    @public
-    @type {Boolean}
+     @public
   */
   get coalesceFindRequests() {
     const coalesceFindRequests = this._coalesceFindRequests;
@@ -367,9 +358,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     }
     ```
      Requests for the `Post` model would now target `/api/1/post/`.
-     @property namespace
-    @public
-    @type {String}
+     @public
   */
 
   /**
@@ -381,15 +370,13 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     }
     ```
      Requests for the `Post` model would now target `https://api.example.com/post/`.
-     @property host
-    @public
-    @type {String}
+     @public
   */
 
   /**
     Some APIs require HTTP headers, e.g. to provide an API
     key. Arbitrary headers can be set as key/value pairs on the
-    `RESTAdapter`'s `headers` object and Ember Data will send them
+    `RESTAdapter`'s `headers` object and WarpDrive will send them
     along with each ajax request..
      ```js [app/adapters/application.js]
     import { RESTAdapter } from '@warp-drive/legacy/adapter/rest';
@@ -402,9 +389,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
       }
     }
     ```
-     @property headers
-    @public
-    @type {Object}
+     @public
    */
 
   /**
@@ -415,11 +400,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      This method performs an HTTP `GET` request with the id provided as part of the query string.
      @since 1.13.0
     @public
-    @param {Store} store
-    @param {Model} type
-    @param {String} id
-    @param {Snapshot} snapshot
-    @return {Promise} promise
   */
   findRecord(store, type, id, snapshot) {
     const url = this.buildURL(type.modelName, id, snapshot, 'findRecord');
@@ -435,18 +415,10 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      The `findAll` method makes an Ajax (HTTP GET) request to a URL computed by `buildURL`, and returns a
     promise for the resulting payload.
      @public
-    @param {Store} store
-    @param {Model} type
-    @param {undefined} neverSet a value is never provided to this argument
-    @param {SnapshotRecordArray} snapshotRecordArray
-    @return {Promise} promise
   */
-  findAll(store, type, sinceToken, snapshotRecordArray) {
+  findAll(store, type, neverUsed, snapshotRecordArray) {
     const query = this.buildQuery(snapshotRecordArray);
     const url = this.buildURL(type.modelName, null, snapshotRecordArray, 'findAll');
-    if (sinceToken) {
-      query.since = sinceToken;
-    }
     return this.ajax(url, 'GET', {
       data: query
     });
@@ -461,12 +433,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      The `query` argument is a simple JavaScript object that will be passed directly
     to the server as parameters.
      @public
-    @param {Store} store
-    @param {Model} type
-    @param {Object} query
-    @param {Collection} recordArray
-    @param {Object} adapterOptions
-    @return {Promise} promise
   */
   query(store, type, query) {
     const url = this.buildURL(type.modelName, null, null, 'query', query);
@@ -488,11 +454,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     to the server as parameters.
      @since 1.13.0
     @public
-    @param {Store} store
-    @param {Model} type
-    @param {Object} query
-    @param {Object} adapterOptions
-    @return {Promise} promise
   */
   queryRecord(store, type, query, adapterOptions) {
     const url = this.buildURL(type.modelName, null, null, 'queryRecord', query);
@@ -524,11 +485,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      The `findMany` method makes an Ajax (HTTP GET) request to a URL computed by `buildURL`, and returns a
     promise for the resulting payload.
      @public
-    @param {Store} store
-    @param {Model} type
-    @param {Array} ids
-    @param {Array} snapshots
-    @return {Promise} promise
   */
   findMany(store, type, ids, snapshots) {
     const url = this.buildURL(type.modelName, ids, snapshots, 'findMany');
@@ -560,11 +516,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      * Links beginning with a single `/` will have the current adapter's `host` value prepended to it.
      * Links with no beginning `/` will have a parentURL prepended to it, via the current adapter's `buildURL`.
      @public
-    @param {Store} store
-    @param {Snapshot} snapshot
-    @param {String} url
-    @param {Object} relationship meta object describing the relationship
-    @return {Promise} promise
   */
   findHasMany(store, snapshot, url, relationship) {
     const id = snapshot.id;
@@ -620,10 +571,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      See `serialize` for information on how to customize the serialized form
     of a record.
      @public
-    @param {Store} store
-    @param {Model} type
-    @param {Snapshot} snapshot
-    @return {Promise} promise
   */
   createRecord(store, type, snapshot) {
     const url = this.buildURL(type.modelName, null, snapshot, 'createRecord');
@@ -641,10 +588,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      See `serialize` for information on how to customize the serialized form
     of a record.
      @public
-    @param {Store} store
-    @param {Model} schema
-    @param {Snapshot} snapshot
-    @return {Promise} promise
   */
   updateRecord(store, schema, snapshot) {
     const data = serializeIntoHash(store, schema, snapshot, {});
@@ -665,10 +608,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     Called by the store when a record is deleted.
      The `deleteRecord` method  makes an Ajax (HTTP DELETE) request to a URL computed by `buildURL`.
      @public
-    @param {Store} store
-    @param {Model} type
-    @param {Snapshot} snapshot
-    @return {Promise} promise
   */
   deleteRecord(store, schema, snapshot) {
     const type = snapshot.modelName;
@@ -680,6 +619,10 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     })(typeof id === 'string' && id.length > 0) : {};
     return this.ajax(this.buildURL(type, id, snapshot, 'deleteRecord'), 'DELETE');
   }
+
+  /**
+    @private
+  */
   _stripIDFromURL(store, snapshot) {
     const type = snapshot.modelName;
     const id = snapshot.id;
@@ -721,10 +664,8 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
      It does not group records that have differing base urls, such as for example: `/posts/1/comments/2`
     and `/posts/2/comments/3`
      @public
-    @param {Store} store
-    @param {Array} snapshots
-    @return {Array}  an array of arrays of records, each of which is to be
-                      loaded separately by `findMany`.
+    @return an array of arrays of records, each of which is to be
+      loaded separately by `findMany`.
   */
   groupRecordsForFindMany(store, snapshots) {
     const groups = new Map();
@@ -763,11 +704,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     method.
      @since 1.13.0
     @public
-    @param  {Number} status
-    @param  {Object} headers
-    @param  {Object} payload
-    @param  {Object} requestData - the original request information
-    @return {Object | AdapterError} response
   */
   handleResponse(status, headers, payload, requestData) {
     if (this.isSuccess(status, headers, payload)) {
@@ -800,10 +736,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     response is a success.
      @since 1.13.0
     @public
-    @param  {Number} status
-    @param  {Object} headers
-    @param  {Object} payload
-    @return {Boolean}
   */
   isSuccess(status, _headers, _payload) {
     return status >= 200 && status < 300 || status === 304;
@@ -814,10 +746,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     response is an invalid error.
      @since 1.13.0
     @public
-    @param  {Number} status
-    @param  {Object} headers
-    @param  {Object} payload
-    @return {Boolean}
   */
   isInvalid(status, _headers, _payload) {
     return status === 422;
@@ -826,7 +754,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
   /**
     Takes a URL, an HTTP method and a hash of data, and makes an
     HTTP request.
-     When the server responds with a payload, Ember Data will call into `extractSingle`
+     When the server responds with a payload, WarpDrive will call into `extractSingle`
     or `extractArray` (depending on whether the original query was for one record or
     many records).
      By default, `ajax` method has the following behavior:
@@ -837,10 +765,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
       data is the serialized record in the case of a save.
     * Registers success and failure handlers.
      @private
-    @param {String} url
-    @param {String} type The request type GET, POST, PUT, DELETE etc.
-    @param {Object} options
-    @return {Promise} promise
   */
   async ajax(url, type, options = {}) {
     const requestData = {
@@ -865,7 +789,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
 
   /**
     @private
-    @param {Object} options jQuery ajax options to be used for the ajax request
+    @param options jQuery ajax options to be used for the ajax request
   */
   _ajaxRequest(options) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -875,10 +799,16 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     })(typeof jQuery !== 'undefined') : {};
     void jQuery.ajax(options);
   }
+  /**
+    @private
+  */
   _fetchRequest(options) {
     const fetchFunction = getFetchFunction();
     return fetchFunction(options.url, options);
   }
+  /**
+    @private
+  */
   _ajax(options) {
     if (this.useFetch) {
       void this._fetchRequest(options);
@@ -889,10 +819,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
 
   /**
     @private
-    @param {String} url
-    @param {String} type The request type GET, POST, PUT, DELETE etc.
-    @param {Object} options
-    @return {Object}
   */
   ajaxOptions(url, method, options) {
     let reqOptions = Object.assign({
@@ -937,6 +863,10 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     reqOptions.url = this._ajaxURL(reqOptions.url);
     return reqOptions;
   }
+
+  /**
+   * @private
+   */
   _ajaxURL(url) {
     if (this.fastboot?.isFastBoot) {
       const httpRegex = /^https?:\/\//;
@@ -949,7 +879,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
         try {
           return `${protocol}//${host}${url}`;
         } catch (fbError) {
-          throw new Error('You are using Ember Data with no host defined in your adapter. This will attempt to use the host of the FastBoot request, which is not configured for the current host of this request. Please set the hostWhitelist property for in your environment.js. FastBoot Error: ' + fbError.message);
+          throw new Error('You are using WarpDrive with no host defined in your adapter. This will attempt to use the host of the FastBoot request, which is not configured for the current host of this request. Please set the hostWhitelist property for in your environment.js. FastBoot Error: ' + fbError.message);
         }
       }
     }
@@ -958,8 +888,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
 
   /**
     @private
-    @param {String} responseText
-    @return {Object}
   */
   parseErrorResponse(responseText) {
     let json = responseText;
@@ -973,10 +901,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
 
   /**
     @private
-    @param  {Number} status
-    @param  {Object} headers
-    @param  {Object} payload
-    @return {Array} errors payload
+    @return errors payload
   */
   normalizeErrorResponse(status, _headers, payload) {
     if (payload && typeof payload === 'object' && 'errors' in payload && Array.isArray(payload.errors)) {
@@ -999,11 +924,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     Generates a detailed ("friendly") error message, with plenty
     of information for debugging (good luck!)
      @private
-    @param  {Number} status
-    @param  {Object} headers
-    @param  {Object} payload
-    @param  {Object} requestData
-    @return {String} detailed error message
+    @return detailed error message
   */
   generatedDetailedMessage(status, headers, payload, requestData) {
     let shortenedPayload;
@@ -1025,8 +946,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     supplied to the ajax method.
      @since 2.5.0
     @public
-    @param  {Snapshot} snapshot
-    @return {Object}
   */
   buildQuery(snapshot) {
     const query = {};
@@ -1167,17 +1086,14 @@ function headersToObject(headers) {
 /**
  * Helper function that translates the options passed to `jQuery.ajax` into a format that `fetch` expects.
  *
- * @param {Object} _options
- * @param {Adapter} adapter
  * @private
- * @return {Object}
  */
 function fetchOptions(options, adapter) {
   options.credentials = options.credentials || 'same-origin';
   if (options.data) {
     // GET and HEAD requests can't have a `body`
     if (options.method === 'GET' || options.method === 'HEAD') {
-      // If no options are passed, Ember Data sets `data` to an empty object, which we test for.
+      // If no options are passed, WarpDrive sets `data` to an empty object, which we test for.
       if (Object.keys(options.data).length && options.url) {
         // Test if there are already query params in the url (mimics jQuey.ajax).
         const queryParamDelimiter = options.url.includes('?') ? '&' : '?';

package/dist/adapter.js

@@ -949,10 +949,10 @@ class Adapter extends EmberObject {
      Serializes the record update and sends it to the server.
      The updateRecord method is expected to return a promise that will
     resolve with the serialized record. This allows the backend to
-    inform the Ember Data store the current state of this record after
+    inform the WarpDrive store the current state of this record after
     the update. If it is not possible to return a serialized record
     the updateRecord promise can also resolve with `undefined` and the
-    Ember Data store will assume all of the updates were successfully
+    WarpDrive store will assume all of the updates were successfully
     applied on the backend.
      Example
      ```js [app/adapters/application.js]

package/dist/compat/-private.js

@@ -1 +1 @@
-export { F as FetchManager, S as SaveOp, c as Snapshot, b as SnapshotRecordArray, u as upgradeStore } from "../-private-B1pSSN52.js";
+export { F as FetchManager, S as SaveOp, c as Snapshot, b as SnapshotRecordArray, u as upgradeStore } from "../-private-BG3bMiKp.js";

package/dist/compat/builders.js

@@ -9,16 +9,16 @@ import { storeFor, recordIdentifierFor } from '@warp-drive/core';
   When passed to `store.request`, this config will result in the same behavior as a `store.findAll` request.
   Additionally, it takes the same options as `store.findAll`.
 
-  All `@ember-data/legacy-compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
+  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
   This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
-  To that end, these builders are deprecated and will be removed in a future version of Ember Data.
+  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
   @deprecated
   @public
-  @param {String} type the name of the resource
-  @param {Object} query a query to be used by the adapter
-  @param {FindAllBuilderOptions} [options] optional, may include `adapterOptions` hash which will be passed to adapter.findAll
-  @return {FindAllRequestInput} request config
+  @param type the name of the resource
+  @param query a query to be used by the adapter
+  @param options optional, may include `adapterOptions` hash which will be passed to adapter.findAll
+  @return request config
 */
 function findAllBuilder(type, options = {}) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -51,7 +51,7 @@ function findAllBuilder(type, options = {}) {
   **Example 1**
 
   ```ts
-  import { findRecord } from '@ember-data/legacy-compat/builders';
+  import { findRecord } from '@warp-drive/legacy/compat/builders';
   const { content: post } = await store.request<Post>(findRecord<Post>('post', '1'));
   ```
 
@@ -62,20 +62,20 @@ function findAllBuilder(type, options = {}) {
   the typical pairing from [JSON:API](https://jsonapi.org/format/#document-resource-object-identification)
 
   ```ts
-  import { findRecord } from '@ember-data/legacy-compat/builders';
+  import { findRecord } from '@warp-drive/legacy/compat/builders';
   const { content: post } = await store.request<Post>(findRecord<Post>({ type: 'post', id }));
   ```
 
-  All `@ember-data/legacy-compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
+  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
   This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
-  To that end, these builders are deprecated and will be removed in a future version of Ember Data.
+  To that end, these builders are deprecated and will be removed in a future version of Warp Drive.
 
   @deprecated
   @public
-  @param {string|object} resource - either a string representing the name of the resource 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|number|object} 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 {FindRecordBuilderOptions} [options] - if the first param is a string this will be the optional options for the request. See examples for available options.
-  @return {FindRecordRequestInput} request config
+  @param resource - either a string representing the name of the resource 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 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.
+  @return request config
 */
 function findRecordBuilder(resource, idOrOptions, options) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -118,16 +118,16 @@ function findRecordBuilder(resource, idOrOptions, options) {
   When passed to `store.request`, this config will result in the same behavior as a `store.query` request.
   Additionally, it takes the same options as `store.query`.
 
-  All `@ember-data/legacy-compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
+  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
   This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
-  To that end, these builders are deprecated and will be removed in a future version of Ember Data.
+  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
   @deprecated
   @public
-  @param {String} type the name of the resource
-  @param {Object} query a query to be used by the adapter
-  @param {QueryBuilderOptions} [options] optional, may include `adapterOptions` hash which will be passed to adapter.query
-  @return {QueryRequestInput} request config
+  @param type the name of the resource
+  @param query a query to be used by the adapter
+  @param options optional, may include `adapterOptions` hash which will be passed to adapter.query
+  @return request config
 */
 function queryBuilder(type, query, options = {}) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -163,16 +163,16 @@ function queryBuilder(type, query, options = {}) {
   When passed to `store.request`, this config will result in the same behavior as a `store.queryRecord` request.
   Additionally, it takes the same options as `store.queryRecord`.
 
-  All `@ember-data/legacy-compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
+  All `@warp-drive/legacy/compat` builders exist to enable you to migrate your codebase to using the correct syntax for `store.request` while temporarily preserving legacy behaviors.
   This is useful for quickly upgrading an entire app to a unified syntax while a longer incremental migration is made to shift off of adapters and serializers.
-  To that end, these builders are deprecated and will be removed in a future version of Ember Data.
+  To that end, these builders are deprecated and will be removed in a future version of WarpDrive.
 
   @deprecated
   @public
-  @param {String} type the name of the resource
-  @param {Object} query a query to be used by the adapter
-  @param {QueryBuilderOptions} [options] optional, may include `adapterOptions` hash which will be passed to adapter.query
-  @return {QueryRecordRequestInput} request config
+  @param type the name of the resource
+  @param query a query to be used by the adapter
+  @param options optional, may include `adapterOptions` hash which will be passed to adapter.query
+  @return request config
 */
 
 function queryRecordBuilder(type, query, options) {