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

package/dist/serializer/rest.js

@@ -1,6 +1,6 @@
 import { warn } from '@ember/debug';
 import { camelize, dasherize, singularize } from '@warp-drive/utilities/string';
-import { J as JSONSerializer, c as coerceId } from "../json-DziiodPf.js";
+import { J as JSONSerializer, c as coerceId } from "../json-ChdEfB0X.js";
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 import Mixin from '@ember/object/mixin';
 
@@ -25,7 +25,7 @@ import Mixin from '@ember/object/mixin';
   Below is an example of a per-type serializer (`post` type).
 
   ```js [app/serializers/post.js]
-  import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data/serializer/rest';
+  import RESTSerializer, { EmbeddedRecordsMixin } from '@warp-drive/legacy/serializer/rest';
 
   export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
     attrs = {
@@ -96,11 +96,6 @@ import Mixin from '@ember/object/mixin';
   are. Please read the docs for the methods this mixin provides, in case you need
   to modify it to fit your specific needs.**
 
-  For example, review the docs for each method of this mixin:
-  * [normalize](/ember-data/release/classes/EmbeddedRecordsMixin/methods/normalize?anchor=normalize)
-  * [serializeBelongsTo](/ember-data/release/classes/EmbeddedRecordsMixin/methods/serializeBelongsTo?anchor=serializeBelongsTo)
-  * [serializeHasMany](/ember-data/release/classes/EmbeddedRecordsMixin/methods/serializeHasMany?anchor=serializeHasMany)
-
   @class EmbeddedRecordsMixin
   @public
 */
@@ -145,7 +140,7 @@ const EmbeddedRecordsMixin = Mixin.create({
     Serialize `belongsTo` relationship when it is configured as an embedded object.
      This example of an author model belongs to a post model:
      ```js
-    import Model, { attr, belongsTo } from '@ember-data/model';
+    import Model, { attr, belongsTo } from '@warp-drive/legacy/model';
      Post = Model.extend({
       title:    attr('string'),
       body:     attr('string'),
@@ -158,7 +153,7 @@ const EmbeddedRecordsMixin = Mixin.create({
     ```
      Use a custom (type) serializer for the post model to configure embedded author
      ```js [app/serializers/post.js]
-    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data/serializer/rest';
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@warp-drive/legacy/serializer/rest';
      export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
       attrs = {
         author: { embedded: 'always' }
@@ -234,7 +229,7 @@ const EmbeddedRecordsMixin = Mixin.create({
     Serializes `hasMany` relationships when it is configured as embedded objects.
      This example of a post model has many comments:
      ```js
-    import Model, { attr, belongsTo, hasMany } from '@ember-data/model';
+    import Model, { attr, belongsTo, hasMany } from '@warp-drive/legacy/model';
      Post = Model.extend({
       title:    attr('string'),
       body:     attr('string'),
@@ -247,7 +242,7 @@ const EmbeddedRecordsMixin = Mixin.create({
     ```
      Use a custom (type) serializer for the post model to configure embedded comments
      ```js [app/serializers/post.js]
-    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data/serializer/rest';
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@warp-drive/legacy/serializer/rest';
      export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
       attrs = {
         comments: { embedded: 'always' }
@@ -279,7 +274,7 @@ const EmbeddedRecordsMixin = Mixin.create({
     `{ serialize: 'records', deserialize: 'records' }`
      To embed the `ids` for a related object (using a hasMany relationship):
      ```js [app/serializers/post.js]
-    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data/serializer/rest';
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@warp-drive/legacy/serializer/rest';
      export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
       attrs = {
         comments: { serialize: 'ids', deserialize: 'records' }
@@ -317,7 +312,7 @@ const EmbeddedRecordsMixin = Mixin.create({
     });
     ```
      ```js [app/serializers/user.js]
-    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data/serializer/rest';
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@warp-drive/legacy/serializer/rest';
      export default class UserSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
       attrs = {
         pets: { serialize: 'ids-and-types', deserialize: 'records' }
@@ -583,13 +578,11 @@ function makeArray(value) {
 }
 
 /**
- * <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}
+  :::
 
   Normally, applications will use the `RESTSerializer` by implementing
   the `normalize` method.
@@ -958,7 +951,7 @@ const RESTSerializer = JSONSerializer.extend({
     the name of the model in your app. Let's take a look at an example model,
     and an example payload:
      ```js [app/models/post.js]
-    import Model from '@ember-data/model';
+    import Model from '@warp-drive/legacy/model';
      export default class Post extends Model {}
     ```
      ```javascript
@@ -1007,7 +1000,7 @@ const RESTSerializer = JSONSerializer.extend({
     each attribute and belongsTo relationship.
      For example, consider this model:
      ```js [app/models/comment.js]
-    import Model, { attr, belongsTo } from '@ember-data/model';
+    import Model, { attr, belongsTo } from '@warp-drive/legacy/model';
      export default class Comment extends Model {
       @attr title
       @attr body

package/dist/serializer/transform.js

@@ -79,11 +79,13 @@ import EmberObject from '@ember/object';
  */
 const Transform = EmberObject;
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
   The `BooleanTransform` class is used to serialize and deserialize
   boolean attributes on Ember Data record objects. This transform is
-  used when `boolean` is passed as the type parameter to the
-  [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+  used when `'boolean'` is passed as the type parameter to the
+  {@link attr}function.
 
   Usage
 
@@ -139,11 +141,13 @@ class BooleanTransform {
   }
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
  The `DateTransform` class is used to serialize and deserialize
  date attributes on Ember Data record objects. This transform is used
- when `date` is passed as the type parameter to the
- [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)
+ when `'date'` is passed as the type parameter to the
+ {@link attr} function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)
  standard.
 
  ```js [app/models/score.js]
@@ -190,6 +194,9 @@ class DateTransform {
     return new this();
   }
 }
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 function isNumber(value) {
   return value === value && value !== Infinity && value !== -Infinity;
 }
@@ -197,7 +204,7 @@ function isNumber(value) {
   The `NumberTransform` class is used to serialize and deserialize
   numeric attributes on Ember Data record objects. This transform is
   used when `number` is passed as the type parameter to the
-  [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+  {@link attr} function.
 
   Usage
 
@@ -235,11 +242,13 @@ class NumberTransform {
   }
 }
 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
 /**
   The `StringTransform` class is used to serialize and deserialize
   string attributes on Ember Data record objects. This transform is
   used when `string` is passed as the type parameter to the
-  [attr](/ember-data/release/functions/@ember-data%2Fmodel/attr) function.
+  {@link attr} function.
 
   Usage
 

package/dist/serializer.js

@@ -5,13 +5,11 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
 /**
   ## 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 serializer, 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 manage and present your data, WarpDrive
   needs to understand the structure of data it receives.
@@ -20,14 +18,14 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
   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.
 
@@ -73,7 +71,7 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
   //   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`.
 
@@ -97,7 +95,7 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
   ### 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
@@ -109,7 +107,6 @@ import { a as decorateFieldV2, i as initializeDeferredDecorator } from "./runtim
 
   @module
 */
-
 const service = s.service ?? s.inject;
 
 /**
@@ -127,8 +124,7 @@ const service = s.service ?? s.inject;
 
     * `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/store.js

@@ -1,7 +1,8 @@
-import { defineSignal, assertPrivateStore, ensureStringId, recordIdentifierFor, constructResource, storeFor } from '@warp-drive/core/store/-private';
+import { assertPrivateStore, ensureStringId, recordIdentifierFor, constructResource, storeFor } from '@warp-drive/core/store/-private';
 import { SkipCache } from '@warp-drive/core/types/request';
 import { i as isMaybeIdentifier } from "./utils-Cqw9eRj5.js";
 import { n as normalizeModelName } from "./util-Dul6TZts.js";
+import { defineSignal } from '@warp-drive/core/signals/-leaked';
 import { getOrSetGlobal } from '@warp-drive/core/types/-private';
 import { macroCondition, getGlobalConfig } from '@embroider/macros';
 
@@ -524,6 +525,9 @@ function restoreDeprecatedStoreBehaviors(StoreKlass) {
     });
     return promise.then(document => document.content);
   };
+
+  // do not put a ts-expect-error here, because typedoc will fail to
+  // build due to this error only occurring when references are in use in the editor
   StoreKlass.prototype.getReference = function (resource, id) {
     macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) ? (test => {
       if (!test) {