@warp-drive/legacy 5.9.0-alpha.21 → 5.9.0-alpha.22

package/dist/serializer/json-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-api.js","names":["warn","dasherize","pluralize","singularize","JSONSerializer","getGlobalConfig","macroCondition","JSONAPISerializer","extend","_normalizeDocumentHelper","documentHash","Array","isArray","data","ret","i","length","normalized","_normalizeResourceHelper","push","included","_normalizeRelationshipDataHelper","relationshipDataHash","type","modelNameFromPayloadKey","resourceHash","WarpDrive","env","DEBUG","test","Error","warnMessageForUndefinedType","store","schema","hasResource","warnMessageNoModelForType","id","modelClass","modelFor","serializer","serializerFor","normalize","pushPayload","payload","normalizedPayload","_normalizeResponse","primaryModelClass","requestType","isSingle","normalizeQueryRecordResponse","_super","arguments","extractAttributes","attributes","eachAttribute","key","attributeKey","keyForAttribute","undefined","modelName","extractRelationship","relationshipHash","extractRelationships","relationships","eachRelationship","relationshipMeta","relationshipKey","keyForRelationship","kind","_extractType","payloadKeyFromModelName","normalizeUsingDeclaredMapping","extractId","lid","applyTransforms","method","typeClass","serialize","snapshot","options","serializeAttribute","json","attribute","_canSerialize","value","attr","transform","transformFor","payloadKey","_getMappedKey","serializeBelongsTo","relationship","name","belongsTo","belongsToIsNotNew","isNew","payloadType","serializeHasMany","shouldSerializeHasMany","hasMany","nonNewHasMany","filter","item","reopen","init","args","toString","isEmbeddedRecordsMixin","isEmbeddedRecordsMixinCompatible","constructor","extractMeta","prototype","originalType","usedLookup"],"sources":["../../src/serializer/json-api.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-return */\n/* eslint-disable @typescript-eslint/no-unsafe-assignment */\n/* eslint-disable @typescript-eslint/no-unsafe-argument */\n/* eslint-disable @typescript-eslint/no-unsafe-member-access */\n/* eslint-disable @typescript-eslint/no-unsafe-call */\nimport { warn } from '@ember/debug';\nimport type EmberObject from '@ember/object';\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { RequestManager } from '@warp-drive/core';\nimport { DEBUG } from '@warp-drive/core/build-config/env';\nimport { assert } from '@warp-drive/core/build-config/macros';\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nimport type { Handler } from '@warp-drive/core/request';\nimport { dasherize, pluralize, singularize } from '@warp-drive/utilities/string';\n\nimport type { Snapshot } from '../compat/-private';\nimport { JSONSerializer } from './json';\n/**\n * :::danger\n    ⚠️ <strong>This is LEGACY documentation</strong> for a feature that is no longer encouraged to be used.\n    If starting a new app or thinking of implementing a new adapter, consider writing a\n    {@link Handler} instead to be used with the {@link RequestManager}\n  :::\n\n  In WarpDrive a Serializer is used to serialize and deserialize\n  records when they are transferred in and out of an external source.\n  This process involves normalizing property names, transforming\n  attribute values and serializing relationships.\n\n  `JSONAPISerializer` supports the http://jsonapi.org/ spec, though\n  even compliant {json:api} servers may find writing an application\n  specific serializer better suited to their needs and more performant.\n\n  This serializer normalizes a JSON API payload that looks like:\n\n  ```js [app/models/player.js]\n  import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n  export default class Player extends Model {\n    @attr('string') name;\n    @attr('string') skill;\n    @attr('number') gamesPlayed;\n    @belongsTo('club') club;\n  }\n  ```\n\n  ```js [app/models/club.js]\n  import Model, { attr, hasMany } from '@warp-drive/legacy/model';\n\n  export default class Club extends Model {\n    @attr('string') name;\n    @attr('string') location;\n    @hasMany('player') players;\n  }\n  ```\n\n  ```js\n    {\n      \"data\": [\n        {\n          \"attributes\": {\n            \"name\": \"Benfica\",\n            \"location\": \"Portugal\"\n          },\n          \"id\": \"1\",\n          \"relationships\": {\n            \"players\": {\n              \"data\": [\n                {\n                  \"id\": \"3\",\n                  \"type\": \"players\"\n                }\n              ]\n            }\n          },\n          \"type\": \"clubs\"\n        }\n      ],\n      \"included\": [\n        {\n          \"attributes\": {\n            \"name\": \"Eusebio Silva Ferreira\",\n            \"skill\": \"Rocket shot\",\n            \"games-played\": 431\n          },\n          \"id\": \"3\",\n          \"relationships\": {\n            \"club\": {\n              \"data\": {\n                \"id\": \"1\",\n                \"type\": \"clubs\"\n              }\n            }\n          },\n          \"type\": \"players\"\n        }\n      ]\n    }\n  ```\n\n  to the format that the JSONAPICache expects.\n\n  ### Customizing meta\n\n  Since a JSON API Document can have meta defined in multiple locations you can\n  use the specific serializer hooks if you need to customize the meta.\n\n  One scenario would be to camelCase the meta keys of your payload. The example\n  below shows how this could be done using `normalizeArrayResponse` and\n  `extractRelationship`.\n\n  ```js [app/serializers/application.js]\n  import { JSONAPISerializer } from '@warp-drive/legacy/serializer/json-api';\n\n  export default class ApplicationSerializer extends JSONAPISerializer {\n    normalizeArrayResponse(store, primaryModelClass, payload, id, requestType) {\n      let normalizedDocument = super.normalizeArrayResponse(...arguments);\n\n      // Customize document meta\n      normalizedDocument.meta = camelCaseKeys(normalizedDocument.meta);\n\n      return normalizedDocument;\n    }\n\n    extractRelationship(relationshipHash) {\n      let normalizedRelationship = super.extractRelationship(...arguments);\n\n      // Customize relationship meta\n      normalizedRelationship.meta = camelCaseKeys(normalizedRelationship.meta);\n\n      return normalizedRelationship;\n    }\n  }\n  ```\n\n  @since 1.13.0\n  @class JSONAPISerializer\n  @public\n*/\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst JSONAPISerializer: any = (JSONSerializer as typeof EmberObject).extend({\n  /**\n    @private\n  */\n  _normalizeDocumentHelper(documentHash) {\n    if (Array.isArray(documentHash.data)) {\n      const ret = [];\n\n      for (let i = 0; i < documentHash.data.length; i++) {\n        const data = documentHash.data[i];\n        const normalized = this._normalizeResourceHelper(data);\n        if (normalized !== null) {\n          // @ts-expect-error untyped\n          // can be null when unknown type is encountered\n          ret.push(normalized);\n        }\n      }\n\n      documentHash.data = ret;\n    } else if (documentHash.data && typeof documentHash.data === 'object') {\n      documentHash.data = this._normalizeResourceHelper(documentHash.data);\n    }\n\n    if (Array.isArray(documentHash.included)) {\n      const ret = [];\n      for (let i = 0; i < documentHash.included.length; i++) {\n        const included = documentHash.included[i];\n        const normalized = this._normalizeResourceHelper(included);\n        if (normalized !== null) {\n          // @ts-expect-error untyped\n          // can be null when unknown type is encountered\n          ret.push(normalized);\n        }\n      }\n\n      documentHash.included = ret;\n    }\n\n    return documentHash;\n  },\n\n  /**\n    @private\n  */\n  _normalizeRelationshipDataHelper(relationshipDataHash) {\n    relationshipDataHash.type = this.modelNameFromPayloadKey(relationshipDataHash.type);\n\n    return relationshipDataHash;\n  },\n\n  /**\n    @private\n  */\n  _normalizeResourceHelper(resourceHash) {\n    // @ts-expect-error untyped\n    assert(this.warnMessageForUndefinedType(), resourceHash.type);\n\n    const type = this.modelNameFromPayloadKey(resourceHash.type);\n\n    // @ts-expect-error store is dynamically added\n    if (!this.store.schema.hasResource({ type })) {\n      if (DEBUG) {\n        // @ts-expect-error untyped\n        warn(this.warnMessageNoModelForType(type, resourceHash.type, 'modelNameFromPayloadKey'), false, {\n          id: 'ds.serializer.model-for-type-missing',\n        });\n      }\n      return null;\n    }\n\n    // @ts-expect-error store is dynamically added\n    const modelClass = this.store.modelFor(type);\n    // @ts-expect-error store is dynamically added\n    const serializer = this.store.serializerFor(type);\n    const { data } = serializer.normalize(modelClass, resourceHash);\n    return data;\n  },\n\n  /**\n    Normalize some data and push it into the store.\n\n    @public\n  */\n  pushPayload(store, payload) {\n    const normalizedPayload = this._normalizeDocumentHelper(payload);\n    store.push(normalizedPayload);\n  },\n\n  /**\n    @return A {json:api} Document\n    @private\n  */\n  _normalizeResponse(store, primaryModelClass, payload, id, requestType, isSingle) {\n    const normalizedPayload = this._normalizeDocumentHelper(payload);\n    return normalizedPayload;\n  },\n\n  normalizeQueryRecordResponse() {\n    // @ts-expect-error untyped\n    const normalized = this._super(...arguments);\n\n    assert(\n      'Expected the primary data returned by the serializer for a `queryRecord` response to be a single object but instead it was an array.',\n      !Array.isArray(normalized.data)\n    );\n\n    return normalized;\n  },\n\n  extractAttributes(modelClass, resourceHash) {\n    const attributes = {};\n\n    if (resourceHash.attributes) {\n      modelClass.eachAttribute((key) => {\n        const attributeKey = this.keyForAttribute(key, 'deserialize');\n        if (resourceHash.attributes[attributeKey] !== undefined) {\n          attributes[key] = resourceHash.attributes[attributeKey];\n        }\n        if (DEBUG) {\n          if (resourceHash.attributes[attributeKey] === undefined && resourceHash.attributes[key] !== undefined) {\n            assert(\n              `Your payload for '${modelClass.modelName}' contains '${key}', but your serializer is setup to look for '${attributeKey}'. This is most likely because Ember Data's JSON API serializer dasherizes attribute keys by default. You should subclass JSONAPISerializer and implement 'keyForAttribute(key) { return key; }' to prevent Ember Data from customizing your attribute keys.`,\n              false\n            );\n          }\n        }\n      });\n    }\n\n    return attributes;\n  },\n\n  /**\n     Returns a relationship formatted as a JSON-API \"relationship object\".\n\n     http://jsonapi.org/format/#document-resource-object-relationships\n\n    @public\n  */\n  extractRelationship(relationshipHash) {\n    if (Array.isArray(relationshipHash.data)) {\n      const ret = new Array(relationshipHash.data.length);\n\n      for (let i = 0; i < relationshipHash.data.length; i++) {\n        const data = relationshipHash.data[i];\n        ret[i] = this._normalizeRelationshipDataHelper(data);\n      }\n\n      relationshipHash.data = ret;\n    } else if (relationshipHash.data && typeof relationshipHash.data === 'object') {\n      relationshipHash.data = this._normalizeRelationshipDataHelper(relationshipHash.data);\n    }\n\n    return relationshipHash;\n  },\n\n  /**\n     Returns the resource's relationships formatted as a JSON-API \"relationships object\".\n\n     http://jsonapi.org/format/#document-resource-object-relationships\n\n    @public\n  */\n  extractRelationships(modelClass, resourceHash) {\n    const relationships = {};\n\n    if (resourceHash.relationships) {\n      modelClass.eachRelationship((key, relationshipMeta) => {\n        const relationshipKey = this.keyForRelationship(key, relationshipMeta.kind, 'deserialize');\n        if (resourceHash.relationships[relationshipKey] !== undefined) {\n          const relationshipHash = resourceHash.relationships[relationshipKey];\n          relationships[key] = this.extractRelationship(relationshipHash);\n        }\n        if (DEBUG) {\n          if (\n            resourceHash.relationships[relationshipKey] === undefined &&\n            resourceHash.relationships[key] !== undefined\n          ) {\n            assert(\n              `Your payload for '${modelClass.modelName}' contains '${key}', but your serializer is setup to look for '${relationshipKey}'. This is most likely because Ember Data's JSON API serializer dasherizes relationship keys by default. You should subclass JSONAPISerializer and implement 'keyForRelationship(key) { return key; }' to prevent Ember Data from customizing your relationship keys.`,\n              false\n            );\n          }\n        }\n      });\n    }\n\n    return relationships;\n  },\n\n  /**\n    @private\n  */\n  _extractType(modelClass, resourceHash) {\n    return this.modelNameFromPayloadKey(resourceHash.type);\n  },\n\n  /**\n    Dasherizes and singularizes the model name in the payload to match\n    the common convention for model names.\n\n    For example the key `posts` would be converted to `post` and the\n    key `studentAssesments` would be converted to `student-assesment`.\n\n    @public\n    @return the model's modelName\n  */\n  modelNameFromPayloadKey(key) {\n    return dasherize(singularize(key));\n  },\n\n  /**\n    Converts the model name to a pluralized version of the model name.\n\n    For example `post` would be converted to `posts` and\n    `student-assesment` would be converted to `student-assesments`.\n\n    @public\n  */\n  payloadKeyFromModelName(modelName) {\n    return pluralize(modelName);\n  },\n\n  normalize(modelClass, resourceHash) {\n    if (resourceHash.attributes) {\n      // @ts-expect-error untyped\n      this.normalizeUsingDeclaredMapping(modelClass, resourceHash.attributes);\n    }\n\n    if (resourceHash.relationships) {\n      // @ts-expect-error untyped\n      this.normalizeUsingDeclaredMapping(modelClass, resourceHash.relationships);\n    }\n\n    const data = {\n      // @ts-expect-error untyped\n      id: this.extractId(modelClass, resourceHash),\n      type: this._extractType(modelClass, resourceHash),\n      attributes: this.extractAttributes(modelClass, resourceHash),\n      relationships: this.extractRelationships(modelClass, resourceHash),\n    };\n\n    if (resourceHash.lid) {\n      // @ts-expect-error untyped\n      data.lid = resourceHash.lid;\n    }\n\n    // @ts-expect-error untyped\n    this.applyTransforms(modelClass, data.attributes);\n\n    return { data };\n  },\n\n  /**\n    `keyForAttribute` can be used to define rules for how to convert an\n    attribute name in your model to a key in your JSON.\n    By default `JSONAPISerializer` follows the format used on the examples of\n    http://jsonapi.org/format and uses dashes as the word separator in the JSON\n    attribute keys.\n\n    This behaviour can be easily customized by extending this method.\n\n    Example\n\n    ```js [app/serializers/application.js]\n    import JSONAPISerializer from '@warp-drive/legacy/serializer/json-api';\n    import { dasherize } from '<app-name>/utils/string-utils';\n\n    export default class ApplicationSerializer extends JSONAPISerializer {\n      keyForAttribute(attr, method) {\n        return dasherize(attr).toUpperCase();\n      }\n    }\n    ```\n\n    @public\n    @return normalized key\n  */\n  keyForAttribute(key, method) {\n    return dasherize(key);\n  },\n\n  /**\n   `keyForRelationship` can be used to define a custom key when\n   serializing and deserializing relationship properties.\n   By default `JSONAPISerializer` follows the format used on the examples of\n   http://jsonapi.org/format and uses dashes as word separators in\n   relationship properties.\n\n   This behaviour can be easily customized by extending this method.\n\n   Example\n\n    ```js [app/serializers/post.js]\n    import JSONAPISerializer from '@warp-drive/legacy/serializer/json-api';\n    import { underscore } from '<app-name>/utils/string-utils';\n\n    export default class ApplicationSerializer extends JSONAPISerializer {\n      keyForRelationship(key, relationship, method) {\n        return underscore(key);\n      }\n    }\n    ```\n    @public\n   @return the normalized key\n  */\n  keyForRelationship(key, typeClass, method) {\n    return dasherize(key);\n  },\n\n  /**\n    Called when a record is saved in order to convert the\n    record into JSON.\n\n    For example, consider this model:\n\n    ```js [app/models/comment.js]\n    import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n    export default class CommentModel extends Model {\n      @attr title;\n      @attr body;\n\n      @belongsTo('user', { async: false, inverse: null })\n      author;\n    }\n    ```\n\n    The default serialization would create a JSON-API resource object like:\n\n    ```javascript\n    {\n      \"data\": {\n        \"type\": \"comments\",\n        \"attributes\": {\n          \"title\": \"Rails is unagi\",\n          \"body\": \"Rails? Omakase? O_O\",\n        },\n        \"relationships\": {\n          \"author\": {\n            \"data\": {\n              \"id\": \"12\",\n              \"type\": \"users\"\n            }\n          }\n        }\n      }\n    }\n    ```\n\n    By default, attributes are passed through as-is, unless\n    you specified an attribute type (`attr('date')`). If\n    you specify a transform, the JavaScript value will be\n    serialized when inserted into the attributes hash.\n\n    Belongs-to relationships are converted into JSON-API\n    resource identifier objects.\n\n    ## IDs\n\n    `serialize` takes an options hash with a single option:\n    `includeId`. If this option is `true`, `serialize` will,\n    by default include the ID in the JSON object it builds.\n\n    The JSONAPIAdapter passes in `includeId: true` when serializing a record\n    for `createRecord` or `updateRecord`.\n\n    ## Customization\n\n    Your server may expect data in a different format than the\n    built-in serialization format.\n\n    In that case, you can implement `serialize` yourself and\n    return data formatted to match your API's expectations, or override\n    the invoked adapter method and do the serialization in the adapter directly\n    by using the provided snapshot.\n\n    If your API's format differs greatly from the JSON:API spec, you should\n    consider authoring your own adapter and serializer instead of extending\n    this class.\n\n    ```js [app/serializers/post.js]\n    import JSONAPISerializer from '@warp-drive/legacy/serializer/json-api';\n\n    export default class PostSerializer extends JSONAPISerializer {\n      serialize(snapshot, options) {\n        let json = {\n          POST_TTL: snapshot.attr('title'),\n          POST_BDY: snapshot.attr('body'),\n          POST_CMS: snapshot.hasMany('comments', { ids: true })\n        };\n\n        if (options.includeId) {\n          json.POST_ID_ = snapshot.id;\n        }\n\n        return json;\n      }\n    }\n    ```\n\n    ## Customizing an App-Wide Serializer\n\n    If you want to define a serializer for your entire\n    application, you'll probably want to use `eachAttribute`\n    and `eachRelationship` on the record.\n\n    ```js [app/serializers/application.js]\n    import JSONAPISerializer from '@warp-drive/legacy/serializer/json-api';\n    import { underscore, singularize } from '<app-name>/utils/string-utils';\n\n    export default class ApplicationSerializer extends JSONAPISerializer {\n      serialize(snapshot, options) {\n        let json = {};\n\n        snapshot.eachAttribute((name) => {\n          json[serverAttributeName(name)] = snapshot.attr(name);\n        });\n\n        snapshot.eachRelationship((name, relationship) => {\n          if (relationship.kind === 'hasMany') {\n            json[serverHasManyName(name)] = snapshot.hasMany(name, { ids: true });\n          }\n        });\n\n        if (options.includeId) {\n          json.ID_ = snapshot.id;\n        }\n\n        return json;\n      }\n    }\n\n    function serverAttributeName(attribute) {\n      return underscore(attribute).toUpperCase();\n    }\n\n    function serverHasManyName(name) {\n      return serverAttributeName(singularize(name)) + '_IDS';\n    }\n    ```\n\n    This serializer will generate JSON that looks like this:\n\n    ```javascript\n    {\n      \"TITLE\": \"Rails is omakase\",\n      \"BODY\": \"Yep. Omakase.\",\n      \"COMMENT_IDS\": [ \"1\", \"2\", \"3\" ]\n    }\n    ```\n\n    ## Tweaking the Default Formatting\n\n    If you just want to do some small tweaks on the default JSON:API formatted response,\n    you can call `super.serialize` first and make the tweaks\n    on the returned object.\n\n    ```js [app/serializers/post.js]\n    import JSONAPISerializer from '@warp-drive/legacy/serializer/json-api';\n\n    export default class PostSerializer extends JSONAPISerializer {\n      serialize(snapshot, options) {\n        let json = super.serialize(...arguments);\n\n        json.data.attributes.subject = json.data.attributes.title;\n        delete json.data.attributes.title;\n\n        return json;\n      }\n    }\n    ```\n\n    @public\n  */\n  serialize(snapshot: Snapshot, options) {\n    // @ts-expect-error untyped\n    const data = this._super(...arguments);\n    data.type = this.payloadKeyFromModelName(snapshot.modelName);\n\n    return { data };\n  },\n\n  serializeAttribute(snapshot, json, key, attribute) {\n    const type = attribute.type;\n\n    // @ts-expect-error untyped\n    if (this._canSerialize(key)) {\n      json.attributes = json.attributes || {};\n\n      let value = snapshot.attr(key);\n      if (type) {\n        // @ts-expect-error untyped\n        const transform = this.transformFor(type);\n        value = transform.serialize(value, attribute.options);\n      }\n\n      // @ts-expect-error store is dynamically added\n      const schema = this.store.modelFor(snapshot.modelName);\n      // @ts-expect-error untyped\n      let payloadKey = this._getMappedKey(key, schema);\n\n      if (payloadKey === key) {\n        payloadKey = this.keyForAttribute(key, 'serialize');\n      }\n\n      json.attributes[payloadKey] = value;\n    }\n  },\n\n  serializeBelongsTo(snapshot: Snapshot, json, relationship) {\n    const name = relationship.name;\n\n    // @ts-expect-error untyped\n    if (this._canSerialize(name)) {\n      const belongsTo = snapshot.belongsTo(name);\n      // @ts-expect-error not narrowed\n      const belongsToIsNotNew = belongsTo && !belongsTo.isNew;\n\n      if (belongsTo === null || belongsToIsNotNew) {\n        json.relationships = json.relationships || {};\n\n        // @ts-expect-error store is dynamically added\n        const schema = this.store.modelFor(snapshot.modelName);\n        // @ts-expect-error untyped\n        let payloadKey = this._getMappedKey(name, schema);\n        if (payloadKey === name) {\n          payloadKey = this.keyForRelationship(name, 'belongsTo', 'serialize');\n        }\n\n        let data = null;\n        if (belongsTo) {\n          // @ts-expect-error not narrowed\n          const payloadType = this.payloadKeyFromModelName(belongsTo.modelName);\n\n          // @ts-expect-error untyped\n          data = {\n            type: payloadType,\n            // @ts-expect-error not narrowed\n            id: belongsTo.id,\n          };\n        }\n\n        json.relationships[payloadKey] = { data };\n      }\n    }\n  },\n\n  serializeHasMany(snapshot: Snapshot, json, relationship) {\n    const name = relationship.name;\n\n    // @ts-expect-error untyped\n    if (this.shouldSerializeHasMany(snapshot, name, relationship)) {\n      const hasMany = snapshot.hasMany(name);\n      if (hasMany !== undefined) {\n        json.relationships = json.relationships || {};\n\n        // @ts-expect-error store is dynamically added\n        const schema = this.store.modelFor(snapshot.modelName);\n        // @ts-expect-error untyped\n        let payloadKey = this._getMappedKey(name, schema);\n        if (payloadKey === name && this.keyForRelationship) {\n          payloadKey = this.keyForRelationship(name, 'hasMany', 'serialize');\n        }\n\n        // only serialize has many relationships that are not new\n        // @ts-expect-error not narrowed\n        const nonNewHasMany = hasMany.filter((item) => !item.isNew);\n        const data = new Array(nonNewHasMany.length);\n\n        for (let i = 0; i < nonNewHasMany.length; i++) {\n          const item = hasMany[i];\n          // @ts-expect-error not narrowed\n          const payloadType = this.payloadKeyFromModelName(item.modelName);\n\n          data[i] = {\n            type: payloadType,\n            // @ts-expect-error not narrowed\n            id: item.id,\n          };\n        }\n\n        json.relationships[payloadKey] = { data };\n      }\n    }\n  },\n});\n\nif (DEBUG) {\n  JSONAPISerializer.reopen({\n    init(...args) {\n      this._super(...args);\n\n      assert(\n        `You've used the EmbeddedRecordsMixin in ${this.toString()} which is not fully compatible with the JSON:API specification. Please confirm that this works for your specific API and add \\`this.isEmbeddedRecordsMixinCompatible = true\\` to your serializer.`,\n        !this.isEmbeddedRecordsMixin || this.isEmbeddedRecordsMixinCompatible === true\n      );\n\n      const constructor = this.constructor;\n      warn(\n        `You've defined 'extractMeta' in ${constructor.toString()} which is not used for serializers extending JSONAPISerializer. Read more at https://api.emberjs.com/ember-data/release/classes/JSONAPISerializer on how to customize meta when using JSON API.`,\n        this.extractMeta === JSONSerializer.prototype.extractMeta,\n        {\n          id: 'ds.serializer.json-api.extractMeta',\n        }\n      );\n    },\n    warnMessageForUndefinedType() {\n      return (\n        'Encountered a resource object with an undefined type (resolved resource using ' +\n        this.constructor.toString() +\n        ')'\n      );\n    },\n    warnMessageNoModelForType(modelName, originalType, usedLookup) {\n      return `Encountered a resource object with type \"${originalType}\", but no model was found for model name \"${modelName}\" (resolved model name using '${this.constructor.toString()}.${usedLookup}(\"${originalType}\")').`;\n    },\n  });\n}\n\nexport { JSONAPISerializer };\n"],"mappings":"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"}

package/{declarations → dist}/serializer/json.d.ts

@@ -1,3 +1,4 @@
+//#region src/serializer/json.d.ts
 /**
 * :::danger
 ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.
@@ -72,4 +73,6 @@ turn the record payload into the JSON API format.
 @public
 */
 declare const JSONSerializer: any;
+//#endregion
 export { JSONSerializer };
+//# sourceMappingURL=json.d.ts.map

package/dist/serializer/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","names":[],"sources":["../../src/serializer/json.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwGM"}

package/dist/serializer/json.js

@@ -1,6 +1,3 @@
-import '@ember/application';
-import '@ember/debug';
-import '@warp-drive/utilities/string';
-import '../serializer.js';
-export { J as JSONSerializer } from "../json-DU8m1pGf.js";
-import '@embroider/macros';
+import { t as JSONSerializer } from "../json-BXNPTlcH.js";
+
+export { JSONSerializer };

package/{declarations/serializer/-private/embedded-records-mixin.d.ts → dist/serializer/rest.d.ts}

@@ -1,4 +1,5 @@
 import Mixin from "@ember/object/mixin";
+//#region src/serializer/-private/embedded-records-mixin.d.ts
 /**
 ## Using Embedded Records
 
@@ -88,4 +89,58 @@ to modify it to fit your specific needs.**
 @class EmbeddedRecordsMixin
 @public
 */
-export declare const EmbeddedRecordsMixin: Mixin;
+declare const EmbeddedRecordsMixin: Mixin;
+//#endregion
+//#region src/serializer/rest.d.ts
+/**
+* :::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
+{@link Handler} instead to be used with the {@link RequestManager}
+:::
+
+Normally, applications will use the `RESTSerializer` by implementing
+the `normalize` method.
+
+This allows you to do whatever kind of munging you need and is
+especially useful if your server is inconsistent and you need to
+do munging differently for many different kinds of responses.
+
+See the `normalize` documentation for more information.
+
+## Across the Board Normalization
+
+There are also a number of hooks that you might find useful to define
+across-the-board rules for your payload. These rules will be useful
+if your server is consistent, or if you're building an adapter for
+an infrastructure service, like Firebase, and want to encode service
+conventions.
+
+For example, if all of your keys are underscored and all-caps, but
+otherwise consistent with the names you use in your models, you
+can implement across-the-board rules for how to convert an attribute
+name in your model to a key in your JSON.
+
+```js [app/serializers/application.js]
+import { RESTSerializer } from '@warp-drive/legacy/serializer/rest';
+import { underscore } from '<app-name>/utils/string-utils';
+
+export default class ApplicationSerializer extends RESTSerializer {
+keyForAttribute(attr, method) {
+return underscore(attr).toUpperCase();
+}
+}
+```
+
+You can also implement `keyForRelationship`, which takes the name
+of the relationship as the first parameter, the kind of
+relationship (`hasMany` or `belongsTo`) as the second parameter, and
+the method (`serialize` or `deserialize`) as the third parameter.
+
+@class RESTSerializer
+@public
+*/
+declare const RESTSerializer: any;
+//#endregion
+export { EmbeddedRecordsMixin, RESTSerializer };
+//# sourceMappingURL=rest.d.ts.map

package/dist/serializer/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","names":[],"sources":["../../src/serializer/-private/embedded-records-mixin.ts","../../src/serializer/rest.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqGa,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCzB7B"}