@ember-data-mirror/serializer 5.4.0-alpha.49

package/LICENSE.md

@@ -0,0 +1,11 @@
+The MIT License (MIT)
+
+Copyright (C) 2017-2023 Ember.js contributors
+Portions Copyright (C) 2011-2017 Tilde, Inc. and contributors.
+Portions Copyright (C) 2011 LivingSocial Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+<p align="center">
+  <img
+    class="project-logo"
+    src="./ember-data-logo-dark.svg#gh-dark-mode-only"
+    alt="EmberData Serializer"
+    width="240px"
+    title="EmberData Serializer"
+    />
+  <img
+    class="project-logo"
+    src="./ember-data-logo-light.svg#gh-light-mode-only"
+    alt="EmberData Serializer"
+    width="240px"
+    title="EmberData Serializer"
+    />
+</p>
+
+<p align="center">Provides JSON, REST and JSON:API Implementations of the legacy <a href="https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Serializer">Serializer Interface</a></p>
+
+> **Caution** ⚠️ **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 [Handler](https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Handler)
+> instead to be used with the [RequestManager](https://github.com/emberjs/data/tree/main/packages/request#readme)
+
+## Installation
+
+This package is currently installed when installing `ember-data`.
+
+If installing `@ember-data/` packages individually install using your javascript package manager of choice. For instance with [pnpm](https://pnpm.io/)
+
+```no-highlight
+pnpm add @ember-data-mirror/serializer
+```
+
+## 🚀 Setup
+
+If using `ember-data` no additional setup is necesssary.
+
+> **Note**
+> When using [ember-data](https://github.com/emberjs/data/blob/main/packages/-ember-data) the below
+> configuration is handled for you automatically.
+
+To use legacy serializers you will need to have installed and configured the LegacyNetworkHandler from [@ember-data-mirror/legacy-compat](https://github.com/emberjs/data/blob/main/packages/-ember-data)
+
+```no-highlight
+pnpm add @ember-data-mirror/legacy-compat
+```
+
+```ts
+import Store, { CacheHandler } from '@ember-data-mirror/store';
+import RequestManager from '@ember-data-mirror/request';
+import { LegacyNetworkHandler } from '@ember-data-mirror/legacy-compat';
+
+export default class extends Store {
+  requestManager = new RequestManager();
+
+  constructor(args) {
+    super(args);
+    this.requestManager.use([LegacyNetworkHandler]);
+    this.requestManager.useCache(CacheHandler);
+  }
+}
+```
+
+
+## Usage
+
+To use as either a per-type or application serializer, export one of the
+implementations within the `serializers/` directory of your app as appropriate.
+
+For instance, to configure an application serializer to use `JSON:API`
+
+
+*app/serializers/application.ts*
+```ts
+export { default } from '@ember-data-mirror/serializer/json-api';
+```
+
+By default serializers are resolved by looking for a serializer with the same name in the `serializers/` folder as the `type` given to `store.serializerFor(<type>)`, falling back to looking for a serializer named `application`.
+
+**Overriding Resolution**
+
+If you would like to avoid using resolver semantics and your application has only one or a few serializers, you may ovveride the `serializerFor` hook on the store.
+
+```ts
+import Store from '@ember-data-mirror/store';
+import Serializer from '@ember-data-mirror/serializer/json-api';
+
+class extends Store {
+  #serializer = new Serializer();
+
+  serializerFor() {
+    return this.#serializer;
+  }
+}
+```
+
+
+For the full list of APIs available read the code documentation for [@ember-data-mirror/serializer](https://api.emberjs.com/ember-data/release/modules/@ember-data%2Fserializer). You may also be interested in learning more about *Ember***Data**'s [Serializer Interface](https://api.emberjs.com/ember-data/release/classes/%3CInterface%3E%20Serializer).

package/addon/-private.js

@@ -0,0 +1,3 @@
+export { e as EmbeddedRecordsMixin } from "./embedded-records-mixin-QJe_8jrF";
+export { B as BooleanTransform, D as DateTransform, N as NumberTransform, S as StringTransform, T as Transform } from "./string-Juwz4cu0";
+export { c as coerceId } from "./utils-NcVD2Jb5";

package/addon/-private.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"-private.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/addon/embedded-records-mixin-QJe_8jrF.js

@@ -0,0 +1,572 @@
+import { warn } from '@ember/debug';
+import Mixin from '@ember/object/mixin';
+import { camelize } from '@ember/string';
+
+/**
+  @module @ember-data-mirror/serializer/rest
+*/
+
+/**
+  ## Using Embedded Records
+
+  `EmbeddedRecordsMixin` supports serializing embedded records.
+
+  To set up embedded records, include the mixin when extending a serializer,
+  then define and configure embedded (model) relationships.
+
+  Note that embedded records will serialize with the serializer for their model instead of the serializer in which they are defined.
+
+  Note also that this mixin does not work with JSONAPISerializer because the JSON:API specification does not describe how to format embedded resources.
+
+  Below is an example of a per-type serializer (`post` type).
+
+  ```app/serializers/post.js
+  import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data-mirror/serializer/rest';
+
+  export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
+    attrs = {
+      author: { embedded: 'always' },
+      comments: { serialize: 'ids' }
+    }
+  }
+  ```
+  Note that this use of `{ embedded: 'always' }` is unrelated to
+  the `{ embedded: 'always' }` that is defined as an option on `attr` as part of
+  defining a model while working with the `ActiveModelSerializer`.  Nevertheless,
+  using `{ embedded: 'always' }` as an option to `attr` is not a valid way to set up
+  embedded records.
+
+  The `attrs` option for a resource `{ embedded: 'always' }` is shorthand for:
+
+  ```js
+  {
+    serialize: 'records',
+    deserialize: 'records'
+  }
+  ```
+
+  ### Configuring Attrs
+
+  A resource's `attrs` option may be set to use `ids`, `records` or false for the
+  `serialize`  and `deserialize` settings.
+
+  The `attrs` property can be set on the `ApplicationSerializer` or a per-type
+  serializer.
+
+  In the case where embedded JSON is expected while extracting a payload (reading)
+  the setting is `deserialize: 'records'`, there is no need to use `ids` when
+  extracting as that is the default behaviour without this mixin if you are using
+  the vanilla `EmbeddedRecordsMixin`. Likewise, to embed JSON in the payload while
+  serializing `serialize: 'records'` is the setting to use. There is an option of
+  not embedding JSON in the serialized payload by using `serialize: 'ids'`. If you
+  do not want the relationship sent at all, you can use `serialize: false`.
+
+
+  ### EmbeddedRecordsMixin defaults
+  If you do not overwrite `attrs` for a specific relationship, the `EmbeddedRecordsMixin`
+  will behave in the following way:
+
+  BelongsTo: `{ serialize: 'id', deserialize: 'id' }`
+  HasMany:   `{ serialize: false, deserialize: 'ids' }`
+
+  ### Model Relationships
+
+  Embedded records must have a model defined to be extracted and serialized. Note that
+  when defining any relationships on your model such as `belongsTo` and `hasMany`, you
+  should not both specify `async: true` and also indicate through the serializer's
+  `attrs` attribute that the related model should be embedded for deserialization.
+  If a model is declared embedded for deserialization (`embedded: 'always'` or `deserialize: 'records'`),
+  then do not use `async: true`.
+
+  To successfully extract and serialize embedded records the model relationships
+  must be set up correctly. See the
+  [defining relationships](https://guides.emberjs.com/current/models/relationships)
+  section of the **Defining Models** guide page.
+
+  Records without an `id` property are not considered embedded records, model
+  instances must have an `id` property to be used with Ember Data.
+
+  ### Example JSON payloads, Models and Serializers
+
+  **When customizing a serializer it is important to grok what the customizations
+  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
+*/
+var embeddedRecordsMixin = Mixin.create({
+  /**
+    Normalize the record and recursively normalize/extract all the embedded records
+    while pushing them into the store as they are encountered
+     A payload with an attr configured for embedded records needs to be extracted:
+     ```js
+    {
+      "post": {
+        "id": "1"
+        "title": "Rails is omakase",
+        "comments": [{
+          "id": "1",
+          "body": "Rails is unagi"
+        }, {
+          "id": "2",
+          "body": "Omakase O_o"
+        }]
+      }
+    }
+    ```
+   @method normalize
+    @public
+   @param {Model} typeClass
+   @param {Object} hash to be normalized
+   @param {String} prop the hash has been referenced by
+   @return {Object} the normalized hash
+  **/
+  normalize(typeClass, hash, prop) {
+    const normalizedHash = this._super(typeClass, hash, prop);
+    return this._extractEmbeddedRecords(this, this.store, typeClass, normalizedHash);
+  },
+  keyForRelationship(key, typeClass, method) {
+    if (method === 'serialize' && this.hasSerializeRecordsOption(key) || method === 'deserialize' && this.hasDeserializeRecordsOption(key)) {
+      return this.keyForAttribute(key, method);
+    } else {
+      return this._super(key, typeClass, method) || key;
+    }
+  },
+  /**
+    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-mirror/model';
+     Post = Model.extend({
+      title:    attr('string'),
+      body:     attr('string'),
+      author:   belongsTo('author')
+    });
+     Author = Model.extend({
+      name:     attr('string'),
+      post:     belongsTo('post')
+    });
+    ```
+     Use a custom (type) serializer for the post model to configure embedded author
+     ```app/serializers/post.js
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data-mirror/serializer/rest';
+     export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
+      attrs = {
+        author: { embedded: 'always' }
+      }
+    }
+    ```
+     A payload with an attribute configured for embedded records can serialize
+    the records together under the root attribute's payload:
+     ```js
+    {
+      "post": {
+        "id": "1"
+        "title": "Rails is omakase",
+        "author": {
+          "id": "2"
+          "name": "dhh"
+        }
+      }
+    }
+    ```
+     @method serializeBelongsTo
+    @public
+    @param {Snapshot} snapshot
+    @param {Object} json
+    @param {Object} relationship
+  */
+  serializeBelongsTo(snapshot, json, relationship) {
+    const attr = relationship.name;
+    if (this.noSerializeOptionSpecified(attr)) {
+      this._super(snapshot, json, relationship);
+      return;
+    }
+    const includeIds = this.hasSerializeIdsOption(attr);
+    const includeRecords = this.hasSerializeRecordsOption(attr);
+    const embeddedSnapshot = snapshot.belongsTo(attr);
+    if (includeIds) {
+      const schema = this.store.modelFor(snapshot.modelName);
+      let serializedKey = this._getMappedKey(relationship.name, schema);
+      if (serializedKey === relationship.name && this.keyForRelationship) {
+        serializedKey = this.keyForRelationship(relationship.name, relationship.kind, 'serialize');
+      }
+      if (!embeddedSnapshot) {
+        json[serializedKey] = null;
+      } else {
+        json[serializedKey] = embeddedSnapshot.id;
+        if (relationship.options.polymorphic) {
+          this.serializePolymorphicType(snapshot, json, relationship);
+        }
+      }
+    } else if (includeRecords) {
+      this._serializeEmbeddedBelongsTo(snapshot, json, relationship);
+    }
+  },
+  _serializeEmbeddedBelongsTo(snapshot, json, relationship) {
+    const embeddedSnapshot = snapshot.belongsTo(relationship.name);
+    const schema = this.store.modelFor(snapshot.modelName);
+    let serializedKey = this._getMappedKey(relationship.name, schema);
+    if (serializedKey === relationship.name && this.keyForRelationship) {
+      serializedKey = this.keyForRelationship(relationship.name, relationship.kind, 'serialize');
+    }
+    if (!embeddedSnapshot) {
+      json[serializedKey] = null;
+    } else {
+      json[serializedKey] = embeddedSnapshot.serialize({
+        includeId: true
+      });
+      this.removeEmbeddedForeignKey(snapshot, embeddedSnapshot, relationship, json[serializedKey]);
+      if (relationship.options.polymorphic) {
+        this.serializePolymorphicType(snapshot, json, relationship);
+      }
+    }
+  },
+  /**
+    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-mirror/model';
+     Post = Model.extend({
+      title:    attr('string'),
+      body:     attr('string'),
+      comments: hasMany('comment')
+    });
+     Comment = Model.extend({
+      body:     attr('string'),
+      post:     belongsTo('post')
+    });
+    ```
+     Use a custom (type) serializer for the post model to configure embedded comments
+     ```app/serializers/post.js
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data-mirror/serializer/rest';
+     export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
+      attrs = {
+        comments: { embedded: 'always' }
+      }
+    }
+    ```
+     A payload with an attribute configured for embedded records can serialize
+    the records together under the root attribute's payload:
+     ```js
+    {
+      "post": {
+        "id": "1"
+        "title": "Rails is omakase",
+        "body": "I want this for my ORM, I want that for my template language..."
+        "comments": [{
+          "id": "1",
+          "body": "Rails is unagi"
+        }, {
+          "id": "2",
+          "body": "Omakase O_o"
+        }]
+      }
+    }
+    ```
+     The attrs options object can use more specific instruction for extracting and
+    serializing. When serializing, an option to embed `ids`, `ids-and-types` or `records` can be set.
+    When extracting the only option is `records`.
+     So `{ embedded: 'always' }` is shorthand for:
+    `{ serialize: 'records', deserialize: 'records' }`
+     To embed the `ids` for a related object (using a hasMany relationship):
+     ```app/serializers/post.js
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data-mirror/serializer/rest';
+     export default class PostSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
+      attrs = {
+        comments: { serialize: 'ids', deserialize: 'records' }
+      }
+    }
+    ```
+     ```js
+    {
+      "post": {
+        "id": "1"
+        "title": "Rails is omakase",
+        "body": "I want this for my ORM, I want that for my template language..."
+        "comments": ["1", "2"]
+      }
+    }
+    ```
+     To embed the relationship as a collection of objects with `id` and `type` keys, set
+    `ids-and-types` for the related object.
+     This is particularly useful for polymorphic relationships where records don't share
+    the same table and the `id` is not enough information.
+     For example having a user that has many pets:
+     ```js
+    User = Model.extend({
+      name: attr('string'),
+      pets: hasMany('pet', { polymorphic: true })
+    });
+     Pet = Model.extend({
+      name: attr('string'),
+    });
+     Cat = Pet.extend({
+      // ...
+    });
+     Parrot = Pet.extend({
+      // ...
+    });
+    ```
+     ```app/serializers/user.js
+    import RESTSerializer, { EmbeddedRecordsMixin } from '@ember-data-mirror/serializer/rest';
+     export default class UserSerializer extends RESTSerializer.extend(EmbeddedRecordsMixin) {
+      attrs = {
+        pets: { serialize: 'ids-and-types', deserialize: 'records' }
+      }
+    }
+    ```
+     ```js
+    {
+      "user": {
+        "id": "1"
+        "name": "Bertin Osborne",
+        "pets": [
+          { "id": "1", "type": "Cat" },
+          { "id": "1", "type": "Parrot"}
+        ]
+      }
+    }
+    ```
+     @method serializeHasMany
+    @public
+    @param {Snapshot} snapshot
+    @param {Object} json
+    @param {Object} relationship
+  */
+  serializeHasMany(snapshot, json, relationship) {
+    const attr = relationship.name;
+    if (this.noSerializeOptionSpecified(attr)) {
+      this._super(snapshot, json, relationship);
+      return;
+    }
+    if (this.hasSerializeIdsOption(attr)) {
+      const schema = this.store.modelFor(snapshot.modelName);
+      let serializedKey = this._getMappedKey(relationship.name, schema);
+      if (serializedKey === relationship.name && this.keyForRelationship) {
+        serializedKey = this.keyForRelationship(relationship.name, relationship.kind, 'serialize');
+      }
+      json[serializedKey] = snapshot.hasMany(attr, {
+        ids: true
+      });
+    } else if (this.hasSerializeRecordsOption(attr)) {
+      this._serializeEmbeddedHasMany(snapshot, json, relationship);
+    } else {
+      if (this.hasSerializeIdsAndTypesOption(attr)) {
+        this._serializeHasManyAsIdsAndTypes(snapshot, json, relationship);
+      }
+    }
+  },
+  /*
+    Serializes a hasMany relationship as an array of objects containing only `id` and `type`
+    keys.
+    This has its use case on polymorphic hasMany relationships where the server is not storing
+    all records in the same table using STI, and therefore the `id` is not enough information
+     TODO: Make the default in Ember-data 3.0??
+  */
+  _serializeHasManyAsIdsAndTypes(snapshot, json, relationship) {
+    const serializedKey = this.keyForAttribute(relationship.name, 'serialize');
+    const hasMany = snapshot.hasMany(relationship.name) || [];
+    json[serializedKey] = hasMany.map(function (recordSnapshot) {
+      //
+      // I'm sure I'm being utterly naive here. Probably id is a configurable property and
+      // type too, and the modelName has to be normalized somehow.
+      //
+      return {
+        id: recordSnapshot.id,
+        type: recordSnapshot.modelName
+      };
+    });
+  },
+  _serializeEmbeddedHasMany(snapshot, json, relationship) {
+    const schema = this.store.modelFor(snapshot.modelName);
+    let serializedKey = this._getMappedKey(relationship.name, schema);
+    if (serializedKey === relationship.name && this.keyForRelationship) {
+      serializedKey = this.keyForRelationship(relationship.name, relationship.kind, 'serialize');
+    }
+    warn(`The embedded relationship '${serializedKey}' is undefined for '${snapshot.modelName}' with id '${snapshot.id}'. Please include it in your original payload.`, typeof snapshot.hasMany(relationship.name) !== 'undefined', {
+      id: 'ds.serializer.embedded-relationship-undefined'
+    });
+    json[serializedKey] = this._generateSerializedHasMany(snapshot, relationship);
+  },
+  /*
+    Returns an array of embedded records serialized to JSON
+  */
+  _generateSerializedHasMany(snapshot, relationship) {
+    const hasMany = snapshot.hasMany(relationship.name) || [];
+    const ret = new Array(hasMany.length);
+    for (let i = 0; i < hasMany.length; i++) {
+      const embeddedSnapshot = hasMany[i];
+      const embeddedJson = embeddedSnapshot.serialize({
+        includeId: true
+      });
+      this.removeEmbeddedForeignKey(snapshot, embeddedSnapshot, relationship, embeddedJson);
+      ret[i] = embeddedJson;
+    }
+    return ret;
+  },
+  /**
+    When serializing an embedded record, modify the property (in the `JSON` payload)
+    that refers to the parent record (foreign key for the relationship).
+     Serializing a `belongsTo` relationship removes the property that refers to the
+    parent record
+     Serializing a `hasMany` relationship does not remove the property that refers to
+    the parent record.
+     @method removeEmbeddedForeignKey
+    @public
+    @param {Snapshot} snapshot
+    @param {Snapshot} embeddedSnapshot
+    @param {Object} relationship
+    @param {Object} json
+  */
+  removeEmbeddedForeignKey(snapshot, embeddedSnapshot, relationship, json) {
+    if (relationship.kind === 'belongsTo') {
+      const schema = this.store.modelFor(snapshot.modelName);
+      const parentRecord = schema.inverseFor(relationship.name, this.store);
+      if (parentRecord) {
+        const name = parentRecord.name;
+        const embeddedSerializer = this.store.serializerFor(embeddedSnapshot.modelName);
+        const parentKey = embeddedSerializer.keyForRelationship(name, parentRecord.kind, 'deserialize');
+        if (parentKey) {
+          delete json[parentKey];
+        }
+      }
+    } /*else if (relationship.kind === 'hasMany') {
+      return;
+      }*/
+  },
+  // checks config for attrs option to embedded (always) - serialize and deserialize
+  hasEmbeddedAlwaysOption(attr) {
+    const option = this.attrsOption(attr);
+    return option && option.embedded === 'always';
+  },
+  // checks config for attrs option to serialize ids
+  hasSerializeRecordsOption(attr) {
+    const alwaysEmbed = this.hasEmbeddedAlwaysOption(attr);
+    const option = this.attrsOption(attr);
+    return alwaysEmbed || option && option.serialize === 'records';
+  },
+  // checks config for attrs option to serialize records
+  hasSerializeIdsOption(attr) {
+    const option = this.attrsOption(attr);
+    return option && (option.serialize === 'ids' || option.serialize === 'id');
+  },
+  // checks config for attrs option to serialize records as objects containing id and types
+  hasSerializeIdsAndTypesOption(attr) {
+    const option = this.attrsOption(attr);
+    return option && (option.serialize === 'ids-and-types' || option.serialize === 'id-and-type');
+  },
+  // checks config for attrs option to serialize records
+  noSerializeOptionSpecified(attr) {
+    const option = this.attrsOption(attr);
+    return !(option && (option.serialize || option.embedded));
+  },
+  // checks config for attrs option to deserialize records
+  // a defined option object for a resource is treated the same as
+  // `deserialize: 'records'`
+  hasDeserializeRecordsOption(attr) {
+    const alwaysEmbed = this.hasEmbeddedAlwaysOption(attr);
+    const option = this.attrsOption(attr);
+    return alwaysEmbed || option && option.deserialize === 'records';
+  },
+  attrsOption(attr) {
+    const attrs = this.attrs;
+    return attrs && (attrs[camelize(attr)] || attrs[attr]);
+  },
+  /**
+   @method _extractEmbeddedRecords
+   @private
+  */
+  _extractEmbeddedRecords(serializer, store, typeClass, partial) {
+    typeClass.eachRelationship((key, relationship) => {
+      if (serializer.hasDeserializeRecordsOption(key)) {
+        if (relationship.kind === 'hasMany') {
+          this._extractEmbeddedHasMany(store, key, partial, relationship);
+        }
+        if (relationship.kind === 'belongsTo') {
+          this._extractEmbeddedBelongsTo(store, key, partial, relationship);
+        }
+      }
+    });
+    return partial;
+  },
+  /**
+   @method _extractEmbeddedHasMany
+   @private
+  */
+  _extractEmbeddedHasMany(store, key, hash, relationshipMeta) {
+    const relationshipHash = hash.data?.relationships?.[key]?.data;
+    if (!relationshipHash) {
+      return;
+    }
+    const hasMany = new Array(relationshipHash.length);
+    for (let i = 0; i < relationshipHash.length; i++) {
+      const item = relationshipHash[i];
+      const {
+        data,
+        included
+      } = this._normalizeEmbeddedRelationship(store, relationshipMeta, item);
+      hash.included = hash.included || [];
+      hash.included.push(data);
+      if (included) {
+        hash.included = hash.included.concat(included);
+      }
+      hasMany[i] = {
+        id: data.id,
+        type: data.type
+      };
+    }
+    const relationship = {
+      data: hasMany
+    };
+    hash.data.relationships[key] = relationship;
+  },
+  /**
+   @method _extractEmbeddedBelongsTo
+   @private
+  */
+  _extractEmbeddedBelongsTo(store, key, hash, relationshipMeta) {
+    const relationshipHash = hash.data?.relationships?.[key]?.data;
+    if (!relationshipHash) {
+      return;
+    }
+    const {
+      data,
+      included
+    } = this._normalizeEmbeddedRelationship(store, relationshipMeta, relationshipHash);
+    hash.included = hash.included || [];
+    hash.included.push(data);
+    if (included) {
+      hash.included = hash.included.concat(included);
+    }
+    const belongsTo = {
+      id: data.id,
+      type: data.type
+    };
+    const relationship = {
+      data: belongsTo
+    };
+    hash.data.relationships[key] = relationship;
+  },
+  /**
+   @method _normalizeEmbeddedRelationship
+   @private
+  */
+  _normalizeEmbeddedRelationship(store, relationshipMeta, relationshipHash) {
+    let modelName = relationshipMeta.type;
+    if (relationshipMeta.options.polymorphic) {
+      modelName = relationshipHash.type;
+    }
+    const modelClass = store.modelFor(modelName);
+    const serializer = store.serializerFor(modelName);
+    return serializer.normalize(modelClass, relationshipHash, null);
+  },
+  isEmbeddedRecordsMixin: true
+});
+export { embeddedRecordsMixin as e };