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

package/dist/adapter/error.js

@@ -3,17 +3,16 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
 /* eslint-disable @typescript-eslint/no-unsafe-assignment */
 /* eslint-disable @typescript-eslint/no-unsafe-member-access */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 
 /**
   ## Overview
 
-  <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+  :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new adapter, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   An `AdapterError` is used by an adapter to signal that an error occurred
   during a request to an external API. It indicates a generic error, and
@@ -25,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." });
   ```
@@ -33,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 {
@@ -126,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.
@@ -147,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() {
@@ -190,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
@@ -236,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
@@ -282,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,8 +1,11 @@
 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-CS0MIv4F.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
+
 class JSONAPIAdapter extends RESTAdapter {
   _defaultContentType = 'application/vnd.api+json';
 

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-CS0MIv4F.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";
@@ -14,13 +14,11 @@ import { d as decorateMethodV2 } from "../runtime-BPCpkOf1-BKOwiRJp.js";
 const AdapterWithBuildURLMixin = Adapter.extend(BuildURLMixin);
 
 /**
- * <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
-  <p>
-    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+ * :::danger
+    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
     If starting a new app or thinking of implementing a new adapter, consider writing a
-    <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
-  </p>
-  </blockquote>
+    {@link Handler} instead to be used with the {@link RequestManager}
+  :::
 
   The REST adapter allows your store to communicate with an HTTP server by
   transmitting JSON via XHR.
@@ -91,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
@@ -152,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.
 
@@ -235,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;
@@ -293,9 +286,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
       }
     }
     ```
-     @param {Object} obj
-    @return {Object}
-    @public
+     @public
   */
   sortQueryParams(obj) {
     const keys = Object.keys(obj);
@@ -344,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;
@@ -369,9 +358,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
     }
     ```
      Requests for the `Post` model would now target `/api/1/post/`.
-     @property namespace
-    @public
-    @type {String}
+     @public
   */
 
   /**
@@ -383,17 +370,14 @@ 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
-    along with each ajax request. For dynamic headers see [headers
-    customization](/ember-data/release/classes/RESTAdapter).
+    `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';
      export default class ApplicationAdapter extends RESTAdapter {
@@ -405,9 +389,7 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
       }
     }
     ```
-     @property headers
-    @public
-    @type {Object}
+     @public
    */
 
   /**
@@ -418,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');
@@ -438,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
     });
@@ -464,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);
@@ -491,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);
@@ -527,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');
@@ -563,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;
@@ -623,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');
@@ -644,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, {});
@@ -668,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;
@@ -683,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;
@@ -724,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();
@@ -766,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)) {
@@ -803,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;
@@ -817,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;
@@ -829,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:
@@ -840,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 = {
@@ -868,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 => {
@@ -878,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);
@@ -892,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({
@@ -940,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?:\/\//;
@@ -952,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);
         }
       }
     }
@@ -961,8 +888,6 @@ class RESTAdapter extends AdapterWithBuildURLMixin {
 
   /**
     @private
-    @param {String} responseText
-    @return {Object}
   */
   parseErrorResponse(responseText) {
     let json = responseText;
@@ -976,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)) {
@@ -1002,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;
@@ -1028,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 = {};
@@ -1170,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

@@ -496,13 +496,11 @@ const BuildURLMixin = Mixin.create(mixinProps);
 /**
  * ## Overview
  *
- * <blockquote style="margin: 1em; padding: .1em 1em .1em 1em; border-left: solid 1em #E34C32; background: #e0e0e0;">
- * <p>
- *   ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.
+ * :::danger
+ *   ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
  *   If starting a new app or thinking of implementing a new adapter, consider writing a
- *   <a href="/ember-data/release/classes/%3CInterface%3E%20Handler">Handler</a> instead to be used with the <a href="https://github.com/warp-drive-data/warp-drive/tree/main/packages/request#readme">RequestManager</a>
- * </p>
- * </blockquote>
+ *   {@link Handler} instead to be used with the {@link RequestManager}
+ * ::::
  *
  * In order to properly fetch and update data, @warp-drive/legacy
  * needs to understand how to connect to your API.
@@ -951,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-8UmnAf9J.js";
+export { F as FetchManager, S as SaveOp, c as Snapshot, b as SnapshotRecordArray, u as upgradeStore } from "../-private-BG3bMiKp.js";