@warp-drive/legacy 5.8.0-alpha.3 → 5.8.0-alpha.32

package/dist/compat/utils.js

@@ -6,7 +6,6 @@ import { macroCondition, getGlobalConfig } from '@embroider/macros';
   and more consistent use of IDs and types.
 
   @module
-  @deprecated
 */
 
 let MismatchReporter = function () {};
@@ -33,7 +32,7 @@ let NormalizedType = str => {
  * changes during normalization. This is useful for instrumenting
  * to discover places where usage in the app is not consistent.
  *
- * @param method a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value
+ * @param fn - a function which takes a mismatch-type ('formatted-id' | 'formatted-type'), actual, and expected value
  * @public
  */
 function configureMismatchReporter(fn) {
@@ -45,7 +44,7 @@ function configureMismatchReporter(fn) {
  * fails validation. This is useful for instrumenting
  * to discover places where usage in the app is not consistent.
  *
- * @param method a function which takes a message and a condition
+ * @param fn - a function which takes a message and a condition
  * @public
  */
 function configureAssertFn(fn) {
@@ -62,7 +61,7 @@ function configureAssertFn(fn) {
  * the configured mismatch reporter and assert functions will
  * be called.
  *
- * @param method a function which takes a string and returns a string
+ * @param fn - a function which takes a string and returns a string
  * @public
  */
 function configureTypeNormalization(fn) {
@@ -72,7 +71,7 @@ const NORMALIZED_TYPES = new Map();
 
 /**
  * Converts a potentially unnormalized type into the format expected
- * by our EmberData Cache. Currently this is singular-dasherized.
+ * by our WarpDrive Cache. Currently this is singular-dasherized.
  *
  * you should not rely on this function to give you an exact format
  * for display purposes. Formatting for display should be handled
@@ -95,8 +94,8 @@ const NORMALIZED_TYPES = new Map();
  * formattedType('PostComment'); // => 'post-comment'
  * ```
  *
- * @param {String} type the potentially un-normalized type
- * @return {String} the normalized type
+ * @param type the potentially un-normalized type
+ * @return the normalized type
  * @public
  */
 function formattedType(type) {
@@ -116,7 +115,7 @@ function formattedType(type) {
 }
 
 /**
- * Format an id to the format expected by the EmberData Cache.
+ * Format an id to the format expected by the WarpDrive Cache.
  * Currently this means that id should be `string | null`.
  *
  * Asserts invalid IDs (undefined, '', 0, '0') in dev.
@@ -131,8 +130,8 @@ function formattedType(type) {
  * formattedId(null); // => null
  *	```
  *
- * @param {String | Number | null} id the potentially un-normalized id
- * @return {String | null} the normalized id
+ * @param id the potentially un-normalized id
+ * @return the normalized id
  * @public
  */
 
@@ -154,7 +153,7 @@ function expectId(id) {
 
 /**
  * Compares two types for strict equality, converting them to
- * the format expected by the EmberData Cache to ensure
+ * the format expected by the WarpDrive Cache to ensure
  * differences in format are accounted for in the comparison.
  *
  * Asserts when expected or actual are invalid types in dev.
@@ -172,9 +171,9 @@ function expectId(id) {
  * isEquivType('posts', null); // false
  * ```
  *
- * @param {String} expected a potentially unnormalized type to match against
- * @param {String} actual a potentially unnormalized type to match against
- * @return {Boolean} true if the types are equivalent
+ * @param expected a potentially unnormalized type to match against
+ * @param actual a potentially unnormalized type to match against
+ * @return true if the types are equivalent
  * @public
  */
 function isEquivType(expected, actual) {
@@ -191,7 +190,7 @@ function isEquivType(expected, actual) {
 
 /**
  * Compares two IDs for strict equality, converting them to
- * the format expected by the EmberData Cache to ensure
+ * the format expected by the WarpDrive Cache to ensure
  * differences in format are accounted for in the comparison.
  *
  * Asserts when expected or actual are invalid IDs in dev.
@@ -205,9 +204,9 @@ function isEquivType(expected, actual) {
  * isEquivId(1, null); // false
  * ```
  *
- * @param {string | number} expected a potentially un-normalized id to match against
- * @param {string | number} actual a potentially un-normalized id to match against
- * @return {Boolean} true if the ids are equivalent
+ * @param expected a potentially un-normalized id to match against
+ * @param actual a potentially un-normalized id to match against
+ * @return true if the ids are equivalent
  * @public
  */
 function isEquivId(expected, actual) {

package/dist/compat.js

@@ -2,7 +2,7 @@ import { getOwner } from '@ember/application';
 import { recordIdentifierFor } from '@warp-drive/core';
 import { assertPrivateStore, waitFor, _deprecatingNormalize } from '@warp-drive/core/store/-private';
 import '@warp-drive/core/reactive/-private';
-import { p as payloadIsNotBlank, n as normalizeResponseHelper, i as iterateData, F as FetchManager, S as SaveOp, a as assertIdentifierHasId, b as SnapshotRecordArray } from "./-private-8UmnAf9J.js";
+import { p as payloadIsNotBlank, n as normalizeResponseHelper, i as iterateData, F as FetchManager, S as SaveOp, a as assertIdentifierHasId, b as SnapshotRecordArray } from "./-private-B1pSSN52.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 function _findHasMany(adapter, store, identifier, link, relationship, options) {
   const promise = Promise.resolve().then(() => {
@@ -737,18 +737,30 @@ function queryRecord(context) {
 }
 
 /**
-    Returns an instance of the adapter for a given type. For
-    example, `adapterFor('person')` will return an instance of
-    the adapter located at `app/adapters/person.js`
+ * Extends the signature of {@link Store} with additional
+ * methods available when using the legacy network layer.
+ *
+ * @public
+ * @noInheritDoc
+ * @legacy
+ */
 
-    If no `person` adapter is found, this method will look
-    for an `application` adapter (the default adapter for
-    your entire application).
+/**
+ * @deprecated - use {@link LegacyStoreCompat} instead
+ */
 
-    @public
-    @param {String} modelName
-    @return {Adapter}
-  */
+/**
+  Returns an instance of the adapter for a given type. For
+  example, `adapterFor('person')` will return an instance of
+  the adapter located at `app/adapters/person.js`
+
+  If no `person` adapter is found, this method will look
+  for an `application` adapter (the default adapter for
+  your entire application).
+
+  @public
+  @param modelName
+*/
 
 function adapterFor(modelName, _allowMissing) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -799,20 +811,19 @@ function adapterFor(modelName, _allowMissing) {
 }
 
 /**
-    Returns an instance of the serializer for a given type. For
-    example, `serializerFor('person')` will return an instance of
-    `App.PersonSerializer`.
+  Returns an instance of the serializer for a given type. For
+  example, `serializerFor('person')` will return an instance of
+  `App.PersonSerializer`.
 
-    If no `App.PersonSerializer` is found, this method will look
-    for an `App.ApplicationSerializer` (the default serializer for
-    your entire application).
+  If no `App.PersonSerializer` is found, this method will look
+  for an `App.ApplicationSerializer` (the default serializer for
+  your entire application).
 
-    If a serializer cannot be found on the adapter, it will fall back
-    to an instance of `JSONSerializer`.
+  If a serializer cannot be found on the adapter, it will fall back
+  to an instance of `JSONSerializer`.
 
-    @public
-    @param {String} modelName the record to serialize
-    @return {Serializer}
+  @public
+  @param modelName the record to serialize
   */
 function serializerFor(modelName) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -859,23 +870,29 @@ function serializerFor(modelName) {
 }
 
 /**
-    `normalize` converts a json payload into the normalized form that
-    [push](../methods/push?anchor=push) expects.
+  `normalize` converts a json payload into the normalized form expected by
+  {@link Store.push | push} using the serializer specified by `modelName`
 
-    Example
+  :::warning
+  Generally it would be better to invoke the serializer yourself directly,
+  or write a more specialized normalization utility.
+  :::
 
-    ```js
-    socket.on('message', function(message) {
-      let modelName = message.model;
-      let data = message.data;
-      store.push(store.normalize(modelName, data));
-    });
-    ```
+  Example
 
-    @public
-    @param modelName The name of the model type for this payload
-    @return The normalized payload
-  */
+  ```js
+  socket.on('message', function(message) {
+    let modelName = message.model;
+    let data = message.data;
+    store.push(store.normalize(modelName, data));
+  });
+  ```
+
+  @legacy
+  @public
+  @param modelName The name of the model type for this payload
+  @return The normalized payload
+*/
 // TODO @runspired @deprecate users should call normalize on the associated serializer directly
 function normalize(modelName, payload) {
   macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
@@ -914,7 +931,7 @@ function normalize(modelName, payload) {
     serializer.
 
     ```js [app/serializers/application.js]
-    import RESTSerializer from '@ember-data/serializer/rest';
+    import RESTSerializer from '@warp-drive/legacy/serializer/rest';
 
     export default class ApplicationSerializer extends RESTSerializer;
     ```
@@ -939,13 +956,13 @@ function normalize(modelName, payload) {
     will determine which serializer will process the payload.
 
     ```js [app/serializers/application.js]
-    import RESTSerializer from '@ember-data/serializer/rest';
+    import RESTSerializer from '@warp-drive/legacy/serializer/rest';
 
      export default class ApplicationSerializer extends RESTSerializer;
     ```
 
     ```js [app/serializers/post.js]
-    import JSONSerializer from '@ember-data/serializer/json';
+    import JSONSerializer from '@warp-drive/legacy/serializer/json';
 
     export default JSONSerializer;
     ```
@@ -956,8 +973,8 @@ function normalize(modelName, payload) {
     ```
 
     @public
-    @param {String} modelName Optionally, a model type used to determine which serializer will be used
-    @param {Object} inputPayload
+    @param modelName Optionally, a model type used to determine which serializer will be used
+    @param inputPayload
   */
 // TODO @runspired @deprecate pushPayload in favor of looking up the serializer
 function pushPayload(modelName, inputPayload) {