@warp-drive/legacy 5.10.0-alpha.2 → 5.10.0-alpha.21

package/dist/unpkg/prod/serializer/transform.js

@@ -1,6 +1,6 @@
 import EmberObject from "@ember/object";
 
-//#region src/serializer/-private/transforms/transform.ts
+// src/serializer/-private/transforms/transform.ts
 /**
 The `Transform` class is used to serialize and deserialize model
 attributes when they are saved or loaded from an
@@ -75,13 +75,14 @@ return new this();
 }
 ```
 
+@summary Legacy base for custom attribute transforms, which implement `serialize` and `deserialize` to convert
+values between payloads and records.
 @class Transform
 @public
 */
 const Transform = EmberObject;
 
-//#endregion
-//#region src/serializer/-private/transforms/boolean.ts
+// src/serializer/-private/transforms/boolean.ts
 /**
 The `BooleanTransform` class is used to serialize and deserialize
 boolean attributes on Ember Data record objects. This transform is
@@ -114,6 +115,8 @@ export default class UserModel extends Model {
 }
 ```
 
+@summary Legacy transform for `attr('boolean')` that converts payload values to and from booleans, optionally
+allowing `null`.
 @public
 */
 var BooleanTransform = class {
@@ -143,8 +146,7 @@ var BooleanTransform = class {
 	}
 };
 
-//#endregion
-//#region src/serializer/-private/transforms/date.ts
+// src/serializer/-private/transforms/date.ts
 /**
 The `DateTransform` class is used to serialize and deserialize
 date attributes on Ember Data record objects. This transform is used
@@ -162,6 +164,8 @@ export default class ScoreModel extends Model {
 }
 ```
 
+@summary Legacy transform for `attr('date')` that converts ISO 8601 strings or epoch numbers to `Date` objects and
+serializes them back to ISO 8601 strings.
 @public
 */
 var DateTransform = class {
@@ -197,8 +201,7 @@ var DateTransform = class {
 	}
 };
 
-//#endregion
-//#region src/serializer/-private/transforms/number.ts
+// src/serializer/-private/transforms/number.ts
 function isNumber(value) {
 	return value === value && value !== Infinity && value !== -Infinity;
 }
@@ -220,6 +223,8 @@ export default class ScoreModel extends Model {
 }
 ```
 
+@summary Legacy transform for `attr('number')` that converts payload values to numbers, or `null` when empty or not
+a valid number.
 @public
 */
 var NumberTransform = class {
@@ -252,8 +257,7 @@ var NumberTransform = class {
 	}
 };
 
-//#endregion
-//#region src/serializer/-private/transforms/string.ts
+// src/serializer/-private/transforms/string.ts
 /**
 The `StringTransform` class is used to serialize and deserialize
 string attributes on Ember Data record objects. This transform is
@@ -272,6 +276,7 @@ export default class UserModel extends Model {
 }
 ```
 
+@summary Legacy transform for `attr('string')` that converts payload values to and from strings.
 @public
 */
 var StringTransform = class {
@@ -296,6 +301,5 @@ var StringTransform = class {
 	}
 };
 
-//#endregion
 export { BooleanTransform, DateTransform, NumberTransform, StringTransform, Transform };
 //# sourceMappingURL=transform.js.map

package/dist/unpkg/prod/serializer/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","names":["EmberObject","Transform","BooleanTransform","deserialize","serialized","options","undefined","allowNull","test","serialize","deserialized","Boolean","create","DateTransform","deserialize","serialized","_options","offset","indexOf","length","Date","slice","undefined","serialize","date","isNaN","toISOString","create","isNumber","value","Infinity","NumberTransform","deserialize","serialized","_options","undefined","transformed","Number","serialize","deserialized","create","StringTransform","deserialize","serialized","_options","String","serialize","deserialized","create"],"sources":["../../../../src/serializer/-private/transforms/transform.ts","../../../../src/serializer/-private/transforms/boolean.ts","../../../../src/serializer/-private/transforms/date.ts","../../../../src/serializer/-private/transforms/number.ts","../../../../src/serializer/-private/transforms/string.ts"],"sourcesContent":["import EmberObject from '@ember/object';\n\nimport type { LegacyAttributeField } from '@warp-drive/core/types/schema/fields';\n\nexport interface Transform {\n  /**\n    When given a deserialized value from a record attribute this\n    method must return the serialized value.\n\n    Example\n\n    ```javascript\n    serialize(deserialized, options) {\n      return deserialized ? null : Number(deserialized);\n    }\n    ```\n\n    @public\n    @param deserialized The deserialized value\n    @param options hash of options passed to `attr`\n    @return The serialized value\n  */\n  serialize(value: unknown, options: LegacyAttributeField['options']): unknown;\n\n  /**\n    When given a serialized value from a JSON object this method must\n    return the deserialized value for the record attribute.\n\n    Example\n\n    ```javascript\n    deserialize(serialized, options) {\n      return empty(serialized) ? null : Number(serialized);\n    }\n    ```\n\n    @public\n    @param serialized The serialized value\n    @param options hash of options passed to `attr`\n    @return The deserialized value\n  */\n  deserialize(value: unknown, options: LegacyAttributeField['options']): unknown;\n}\n\n/**\n  The `Transform` class is used to serialize and deserialize model\n  attributes when they are saved or loaded from an\n  adapter. Subclassing `Transform` is useful for creating custom\n  attributes. All subclasses of `Transform` must implement a\n  `serialize` and a `deserialize` method.\n\n  Example\n\n  ```js [app/transforms/temperature.js]\n\n  // Converts centigrade in the JSON to fahrenheit in the app\n  export default class TemperatureTransform {\n    deserialize(serialized, options) {\n      return (serialized *  1.8) + 32;\n    }\n\n    serialize(deserialized, options) {\n      return (deserialized - 32) / 1.8;\n    }\n\n    static create() {\n      return new this();\n    }\n  }\n  ```\n\n  Usage\n\n  ```js [app/models/requirement.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class RequirementModel extends Model {\n    @attr('string') name;\n    @attr('temperature') temperature;\n  }\n  ```\n\n  The options passed into the `attr` function when the attribute is\n  declared on the model is also available in the transform.\n\n  ```js [app/models/post.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class PostModel extends Model {\n    @attr('string') title;\n    @attr('markdown', {\n      markdown: {\n        gfm: false,\n        sanitize: true\n      }\n    })\n    markdown;\n  }\n  ```\n\n  ```js [app/transforms/markdown.js]\n  export default class MarkdownTransform {\n    serialize(deserialized, options) {\n      return deserialized.raw;\n    }\n\n    deserialize(serialized, options) {\n      let markdownOptions = options.markdown || {};\n\n      return marked(serialized, markdownOptions);\n    }\n\n    static create() {\n      return new this();\n    }\n  }\n  ```\n\n  @class Transform\n  @public\n */\nexport const Transform: typeof EmberObject = EmberObject;\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nexport interface BooleanTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'boolean';\n}\n\n/**\n  The `BooleanTransform` class is used to serialize and deserialize\n  boolean attributes on Ember Data record objects. This transform is\n  used when `'boolean'` is passed as the type parameter to the\n  {@link attr}function.\n\n  Usage\n\n  ```js [app/models/user.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @attr('boolean') isAdmin;\n    @attr('string') name;\n    @attr('string') email;\n  }\n  ```\n\n  By default, the boolean transform only allows for values of `true` or\n  `false`. You can opt into allowing `null` values for\n  boolean attributes via `attr('boolean', { allowNull: true })`\n\n  ```js [app/models/user.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @attr('string') email;\n    @attr('string') username;\n    @attr('boolean', { allowNull: true }) wantsWeeklyEmail;\n  }\n  ```\n\n  @public\n */\nexport class BooleanTransform {\n  /**\n   * Converts a serialized (raw payload) value into a `boolean` (or `null`\n   * when `allowNull` is set and the value is nullish).\n   */\n  deserialize(serialized: boolean | null | number | string, options?: { allowNull?: boolean }): boolean | null {\n    if ((serialized === null || serialized === undefined) && options?.allowNull === true) {\n      return null;\n    }\n\n    if (typeof serialized === 'boolean') {\n      return serialized;\n    } else if (typeof serialized === 'string') {\n      return /^(true|t|1)$/i.test(serialized);\n    } else if (typeof serialized === 'number') {\n      return serialized === 1;\n    } else {\n      return false;\n    }\n  }\n\n  /**\n   * Converts a `boolean` attribute value into its serialized (raw payload) form.\n   */\n  serialize(deserialized: boolean | null, options?: { allowNull?: boolean }): boolean | null {\n    if ((deserialized === null || deserialized === undefined) && options?.allowNull === true) {\n      return null;\n    }\n\n    return Boolean(deserialized);\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): BooleanTransform {\n    return new this();\n  }\n}\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nexport interface DateTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'date';\n}\n/**\n The `DateTransform` class is used to serialize and deserialize\n date attributes on Ember Data record objects. This transform is used\n when `'date'` is passed as the type parameter to the\n {@link attr} function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)\n standard.\n\n ```js [app/models/score.js]\n import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n export default class ScoreModel extends Model {\n    @attr('number') value;\n    @belongsTo('player') player;\n    @attr('date') date;\n  }\n ```\n\n  @public\n */\n\nexport class DateTransform {\n  /**\n   * Converts a serialized (raw payload) `ISO 8601` string, epoch number,\n   * or nullish value into a `Date` (or `null`/`undefined`).\n   */\n  deserialize(serialized: string | number | null, _options?: Record<string, unknown>): Date | null {\n    if (typeof serialized === 'string') {\n      let offset = serialized.indexOf('+');\n\n      if (offset !== -1 && serialized.length - 5 === offset) {\n        offset += 3;\n        return new Date(serialized.slice(0, offset) + ':' + serialized.slice(offset));\n      }\n      return new Date(serialized);\n    } else if (typeof serialized === 'number') {\n      return new Date(serialized);\n    } else if (serialized === null || serialized === undefined) {\n      // if the value is null return null\n      // if the value is not present in the data return undefined\n      return serialized;\n    } else {\n      return null;\n    }\n  }\n\n  /**\n   * Converts a `Date` attribute value into an `ISO 8601` string, or `null`\n   * if the value is not a valid `Date`.\n   */\n  serialize(date: Date, _options?: Record<string, unknown>): string | null {\n    // @ts-expect-error isNaN accepts date as it is coercible\n    if (date instanceof Date && !isNaN(date)) {\n      return date.toISOString();\n    } else {\n      return null;\n    }\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): DateTransform {\n    return new this();\n  }\n}\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nfunction isNumber(value: number) {\n  return value === value && value !== Infinity && value !== -Infinity;\n}\n\nexport interface NumberTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'number';\n}\n\n/**\n  The `NumberTransform` class is used to serialize and deserialize\n  numeric attributes on Ember Data record objects. This transform is\n  used when `number` is passed as the type parameter to the\n  {@link attr} function.\n\n  Usage\n\n  ```js [app/models/score.js]\n  import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n  export default class ScoreModel extends Model {\n    @attr('number') value;\n    @belongsTo('player') player;\n    @attr('date') date;\n  }\n  ```\n\n  @public\n */\nexport class NumberTransform {\n  /**\n   * Converts a serialized (raw payload) value into a `number`, or `null`\n   * if the value is empty, nullish, or not a valid number.\n   */\n  deserialize(serialized: string | number | null | undefined, _options?: Record<string, unknown>): number | null {\n    if (serialized === '' || serialized === null || serialized === undefined) {\n      return null;\n    } else {\n      const transformed = Number(serialized);\n\n      return isNumber(transformed) ? transformed : null;\n    }\n  }\n\n  /**\n   * Converts a `number` attribute value into its serialized (raw payload) form.\n   */\n  serialize(deserialized: string | number | null | undefined, _options?: Record<string, unknown>): number | null {\n    if (deserialized === '' || deserialized === null || deserialized === undefined) {\n      return null;\n    } else {\n      const transformed = Number(deserialized);\n\n      return isNumber(transformed) ? transformed : null;\n    }\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): NumberTransform {\n    return new this();\n  }\n}\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nexport interface StringTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'string';\n}\n/**\n  The `StringTransform` class is used to serialize and deserialize\n  string attributes on Ember Data record objects. This transform is\n  used when `string` is passed as the type parameter to the\n  {@link attr} function.\n\n  Usage\n\n  ```js [app/models/user.js]\n  import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @attr('boolean') isAdmin;\n    @attr('string') name;\n    @attr('string') email;\n  }\n  ```\n\n  @public\n */\nexport class StringTransform {\n  /**\n   * Converts a serialized (raw payload) value into a `string`, or `null`\n   * if the value is falsy (and not an empty string).\n   */\n  deserialize(serialized: unknown, _options?: Record<string, unknown>): string | null {\n    return !serialized && serialized !== '' ? null : String(serialized);\n  }\n  /**\n   * Converts a `string` attribute value into its serialized (raw payload) form.\n   */\n  serialize(deserialized: unknown, _options?: Record<string, unknown>): string | null {\n    return !deserialized && deserialized !== '' ? null : String(deserialized);\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): StringTransform {\n    return new this();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyHA,MAAaC,YAAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC3E7C,IAAaE,mBAAb,MAA8B;;;;;CAK5BC,YAAYC,YAA8CC,SAAmD;EAC3G,KAAKD,eAAe,QAAQA,eAAeE,WAAcD,SAASE,cAAc,MAC9E,OAAO;EAGT,IAAI,OAAOH,eAAe,WACxB,OAAOA;OACF,IAAI,OAAOA,eAAe,UAC/B,OAAO,gBAAgBI,KAAKJ,UAAU;OACjC,IAAI,OAAOA,eAAe,UAC/B,OAAOA,eAAe;OAEtB,OAAO;CAEX;;;;CAKAK,UAAUC,cAA8BL,SAAmD;EACzF,KAAKK,iBAAiB,QAAQA,iBAAiBJ,WAAcD,SAASE,cAAc,MAClF,OAAO;EAGT,OAAOI,QAAQD,YAAY;CAC7B;;;;CAKA,OAAOE,SAA2B;EAChC,OAAO,IAAI,KAAK;CAClB;AACF;;;;;;;;;;;;;;;;;;;;;;;ACrDA,IAAaC,gBAAb,MAA2B;;;;;CAKzBC,YAAYC,YAAoCC,UAAiD;EAC/F,IAAI,OAAOD,eAAe,UAAU;GAClC,IAAIE,SAASF,WAAWG,QAAQ,GAAG;GAEnC,IAAID,WAAW,MAAMF,WAAWI,SAAS,MAAMF,QAAQ;IACrDA,UAAU;IACV,uBAAO,IAAIG,KAAKL,WAAWM,MAAM,GAAGJ,MAAM,IAAI,MAAMF,WAAWM,MAAMJ,MAAM,CAAC;GAC9E;GACA,OAAO,IAAIG,KAAKL,UAAU;EAC5B,OAAO,IAAI,OAAOA,eAAe,UAC/B,OAAO,IAAIK,KAAKL,UAAU;OACrB,IAAIA,eAAe,QAAQA,eAAeO,QAG/C,OAAOP;OAEP,OAAO;CAEX;;;;;CAMAQ,UAAUC,MAAYR,UAAmD;EAEvE,IAAIQ,gBAAgBJ,QAAQ,CAACK,MAAMD,IAAI,GACrC,OAAOA,KAAKE,YAAY;OAExB,OAAO;CAEX;;;;CAKA,OAAOC,SAAwB;EAC7B,OAAO,IAAI,KAAK;CAClB;AACF;;;;ACtEA,SAASC,SAASC,OAAe;CAC/B,OAAOA,UAAUA,SAASA,UAAUC,YAAYD,UAAU;AAC5D;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAaE,kBAAb,MAA6B;;;;;CAK3BC,YAAYC,YAAgDC,UAAmD;EAC7G,IAAID,eAAe,MAAMA,eAAe,QAAQA,eAAeE,QAC7D,OAAO;OACF;GACL,MAAMC,cAAcC,OAAOJ,UAAU;GAErC,OAAOL,SAASQ,WAAW,IAAIA,cAAc;EAC/C;CACF;;;;CAKAE,UAAUC,cAAkDL,UAAmD;EAC7G,IAAIK,iBAAiB,MAAMA,iBAAiB,QAAQA,iBAAiBJ,QACnE,OAAO;OACF;GACL,MAAMC,cAAcC,OAAOE,YAAY;GAEvC,OAAOX,SAASQ,WAAW,IAAIA,cAAc;EAC/C;CACF;;;;CAKA,OAAOI,SAA0B;EAC/B,OAAO,IAAI,KAAK;CAClB;AACF;;;;;;;;;;;;;;;;;;;;;;;;ACvCA,IAAaC,kBAAb,MAA6B;;;;;CAK3BC,YAAYC,YAAqBC,UAAmD;EAClF,OAAO,CAACD,cAAcA,eAAe,KAAK,OAAOE,OAAOF,UAAU;CACpE;;;;CAIAG,UAAUC,cAAuBH,UAAmD;EAClF,OAAO,CAACG,gBAAgBA,iBAAiB,KAAK,OAAOF,OAAOE,YAAY;CAC1E;;;;CAKA,OAAOC,SAA0B;EAC/B,OAAO,IAAI,KAAK;CAClB;AACF"}
+{"version":3,"file":"transform.js","names":["EmberObject","Transform","BooleanTransform","deserialize","serialized","options","undefined","allowNull","test","serialize","deserialized","Boolean","create","DateTransform","deserialize","serialized","_options","offset","indexOf","length","Date","slice","undefined","serialize","date","isNaN","toISOString","create","isNumber","value","Infinity","NumberTransform","deserialize","serialized","_options","undefined","transformed","Number","serialize","deserialized","create","StringTransform","deserialize","serialized","_options","String","serialize","deserialized","create"],"sources":["../../../../src/serializer/-private/transforms/transform.ts","../../../../src/serializer/-private/transforms/boolean.ts","../../../../src/serializer/-private/transforms/date.ts","../../../../src/serializer/-private/transforms/number.ts","../../../../src/serializer/-private/transforms/string.ts"],"sourcesContent":["import EmberObject from '@ember/object';\n\nimport type { LegacyAttributeField } from '@warp-drive/core/types/schema/fields';\n\nexport interface Transform {\n  /**\n    When given a deserialized value from a record attribute this\n    method must return the serialized value.\n\n    Example\n\n    ```javascript\n    serialize(deserialized, options) {\n      return deserialized ? null : Number(deserialized);\n    }\n    ```\n\n    @public\n    @param deserialized The deserialized value\n    @param options hash of options passed to `attr`\n    @return The serialized value\n  */\n  serialize(value: unknown, options: LegacyAttributeField['options']): unknown;\n\n  /**\n    When given a serialized value from a JSON object this method must\n    return the deserialized value for the record attribute.\n\n    Example\n\n    ```javascript\n    deserialize(serialized, options) {\n      return empty(serialized) ? null : Number(serialized);\n    }\n    ```\n\n    @public\n    @param serialized The serialized value\n    @param options hash of options passed to `attr`\n    @return The deserialized value\n  */\n  deserialize(value: unknown, options: LegacyAttributeField['options']): unknown;\n}\n\n/**\n  The `Transform` class is used to serialize and deserialize model\n  attributes when they are saved or loaded from an\n  adapter. Subclassing `Transform` is useful for creating custom\n  attributes. All subclasses of `Transform` must implement a\n  `serialize` and a `deserialize` method.\n\n  Example\n\n  ```js [app/transforms/temperature.js]\n\n  // Converts centigrade in the JSON to fahrenheit in the app\n  export default class TemperatureTransform {\n    deserialize(serialized, options) {\n      return (serialized *  1.8) + 32;\n    }\n\n    serialize(deserialized, options) {\n      return (deserialized - 32) / 1.8;\n    }\n\n    static create() {\n      return new this();\n    }\n  }\n  ```\n\n  Usage\n\n  ```js [app/models/requirement.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class RequirementModel extends Model {\n    @attr('string') name;\n    @attr('temperature') temperature;\n  }\n  ```\n\n  The options passed into the `attr` function when the attribute is\n  declared on the model is also available in the transform.\n\n  ```js [app/models/post.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class PostModel extends Model {\n    @attr('string') title;\n    @attr('markdown', {\n      markdown: {\n        gfm: false,\n        sanitize: true\n      }\n    })\n    markdown;\n  }\n  ```\n\n  ```js [app/transforms/markdown.js]\n  export default class MarkdownTransform {\n    serialize(deserialized, options) {\n      return deserialized.raw;\n    }\n\n    deserialize(serialized, options) {\n      let markdownOptions = options.markdown || {};\n\n      return marked(serialized, markdownOptions);\n    }\n\n    static create() {\n      return new this();\n    }\n  }\n  ```\n\n  @summary Legacy base for custom attribute transforms, which implement `serialize` and `deserialize` to convert\n  values between payloads and records.\n  @class Transform\n  @public\n */\nexport const Transform: typeof EmberObject = EmberObject;\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nexport interface BooleanTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'boolean';\n}\n\n/**\n  The `BooleanTransform` class is used to serialize and deserialize\n  boolean attributes on Ember Data record objects. This transform is\n  used when `'boolean'` is passed as the type parameter to the\n  {@link attr}function.\n\n  Usage\n\n  ```js [app/models/user.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @attr('boolean') isAdmin;\n    @attr('string') name;\n    @attr('string') email;\n  }\n  ```\n\n  By default, the boolean transform only allows for values of `true` or\n  `false`. You can opt into allowing `null` values for\n  boolean attributes via `attr('boolean', { allowNull: true })`\n\n  ```js [app/models/user.js]\n  import { Model, attr } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @attr('string') email;\n    @attr('string') username;\n    @attr('boolean', { allowNull: true }) wantsWeeklyEmail;\n  }\n  ```\n\n  @summary Legacy transform for `attr('boolean')` that converts payload values to and from booleans, optionally\n  allowing `null`.\n  @public\n */\nexport class BooleanTransform {\n  /**\n   * Converts a serialized (raw payload) value into a `boolean` (or `null`\n   * when `allowNull` is set and the value is nullish).\n   */\n  deserialize(serialized: boolean | null | number | string, options?: { allowNull?: boolean }): boolean | null {\n    if ((serialized === null || serialized === undefined) && options?.allowNull === true) {\n      return null;\n    }\n\n    if (typeof serialized === 'boolean') {\n      return serialized;\n    } else if (typeof serialized === 'string') {\n      return /^(true|t|1)$/i.test(serialized);\n    } else if (typeof serialized === 'number') {\n      return serialized === 1;\n    } else {\n      return false;\n    }\n  }\n\n  /**\n   * Converts a `boolean` attribute value into its serialized (raw payload) form.\n   */\n  serialize(deserialized: boolean | null, options?: { allowNull?: boolean }): boolean | null {\n    if ((deserialized === null || deserialized === undefined) && options?.allowNull === true) {\n      return null;\n    }\n\n    return Boolean(deserialized);\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): BooleanTransform {\n    return new this();\n  }\n}\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nexport interface DateTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'date';\n}\n/**\n The `DateTransform` class is used to serialize and deserialize\n date attributes on Ember Data record objects. This transform is used\n when `'date'` is passed as the type parameter to the\n {@link attr} function. It uses the [`ISO 8601`](https://en.wikipedia.org/wiki/ISO_8601)\n standard.\n\n ```js [app/models/score.js]\n import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n export default class ScoreModel extends Model {\n    @attr('number') value;\n    @belongsTo('player') player;\n    @attr('date') date;\n  }\n ```\n\n  @summary Legacy transform for `attr('date')` that converts ISO 8601 strings or epoch numbers to `Date` objects and\n  serializes them back to ISO 8601 strings.\n  @public\n */\n\nexport class DateTransform {\n  /**\n   * Converts a serialized (raw payload) `ISO 8601` string, epoch number,\n   * or nullish value into a `Date` (or `null`/`undefined`).\n   */\n  deserialize(serialized: string | number | null, _options?: Record<string, unknown>): Date | null {\n    if (typeof serialized === 'string') {\n      let offset = serialized.indexOf('+');\n\n      if (offset !== -1 && serialized.length - 5 === offset) {\n        offset += 3;\n        return new Date(serialized.slice(0, offset) + ':' + serialized.slice(offset));\n      }\n      return new Date(serialized);\n    } else if (typeof serialized === 'number') {\n      return new Date(serialized);\n    } else if (serialized === null || serialized === undefined) {\n      // if the value is null return null\n      // if the value is not present in the data return undefined\n      return serialized;\n    } else {\n      return null;\n    }\n  }\n\n  /**\n   * Converts a `Date` attribute value into an `ISO 8601` string, or `null`\n   * if the value is not a valid `Date`.\n   */\n  serialize(date: Date, _options?: Record<string, unknown>): string | null {\n    // @ts-expect-error isNaN accepts date as it is coercible\n    if (date instanceof Date && !isNaN(date)) {\n      return date.toISOString();\n    } else {\n      return null;\n    }\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): DateTransform {\n    return new this();\n  }\n}\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nfunction isNumber(value: number) {\n  return value === value && value !== Infinity && value !== -Infinity;\n}\n\nexport interface NumberTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'number';\n}\n\n/**\n  The `NumberTransform` class is used to serialize and deserialize\n  numeric attributes on Ember Data record objects. This transform is\n  used when `number` is passed as the type parameter to the\n  {@link attr} function.\n\n  Usage\n\n  ```js [app/models/score.js]\n  import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n  export default class ScoreModel extends Model {\n    @attr('number') value;\n    @belongsTo('player') player;\n    @attr('date') date;\n  }\n  ```\n\n  @summary Legacy transform for `attr('number')` that converts payload values to numbers, or `null` when empty or not\n  a valid number.\n  @public\n */\nexport class NumberTransform {\n  /**\n   * Converts a serialized (raw payload) value into a `number`, or `null`\n   * if the value is empty, nullish, or not a valid number.\n   */\n  deserialize(serialized: string | number | null | undefined, _options?: Record<string, unknown>): number | null {\n    if (serialized === '' || serialized === null || serialized === undefined) {\n      return null;\n    } else {\n      const transformed = Number(serialized);\n\n      return isNumber(transformed) ? transformed : null;\n    }\n  }\n\n  /**\n   * Converts a `number` attribute value into its serialized (raw payload) form.\n   */\n  serialize(deserialized: string | number | null | undefined, _options?: Record<string, unknown>): number | null {\n    if (deserialized === '' || deserialized === null || deserialized === undefined) {\n      return null;\n    } else {\n      const transformed = Number(deserialized);\n\n      return isNumber(transformed) ? transformed : null;\n    }\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): NumberTransform {\n    return new this();\n  }\n}\n","import type { TransformName } from '@warp-drive/core/types/symbols';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { attr } from '../../../model';\n\nexport interface StringTransform {\n  /**\n   * see {@link TransformName}\n   */\n  [TransformName]: 'string';\n}\n/**\n  The `StringTransform` class is used to serialize and deserialize\n  string attributes on Ember Data record objects. This transform is\n  used when `string` is passed as the type parameter to the\n  {@link attr} function.\n\n  Usage\n\n  ```js [app/models/user.js]\n  import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @attr('boolean') isAdmin;\n    @attr('string') name;\n    @attr('string') email;\n  }\n  ```\n\n  @summary Legacy transform for `attr('string')` that converts payload values to and from strings.\n  @public\n */\nexport class StringTransform {\n  /**\n   * Converts a serialized (raw payload) value into a `string`, or `null`\n   * if the value is falsy (and not an empty string).\n   */\n  deserialize(serialized: unknown, _options?: Record<string, unknown>): string | null {\n    return !serialized && serialized !== '' ? null : String(serialized);\n  }\n  /**\n   * Converts a `string` attribute value into its serialized (raw payload) form.\n   */\n  serialize(deserialized: unknown, _options?: Record<string, unknown>): string | null {\n    return !deserialized && deserialized !== '' ? null : String(deserialized);\n  }\n\n  /**\n   * Creates a new instance of this transform.\n   */\n  static create(): StringTransform {\n    return new this();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2HA,MAAaC,YAAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC3E7C,IAAaE,mBAAb,MAA8B;;;;;CAK5BC,YAAYC,YAA8CC,SAAmD;EAC3G,KAAKD,eAAe,QAAQA,eAAeE,WAAcD,SAASE,cAAc,MAC9E,OAAO;EAGT,IAAI,OAAOH,eAAe,WACxB,OAAOA;OACF,IAAI,OAAOA,eAAe,UAC/B,OAAO,gBAAgBI,KAAKJ,UAAU;OACjC,IAAI,OAAOA,eAAe,UAC/B,OAAOA,eAAe;OAEtB,OAAO;CAEX;;;;CAKAK,UAAUC,cAA8BL,SAAmD;EACzF,KAAKK,iBAAiB,QAAQA,iBAAiBJ,WAAcD,SAASE,cAAc,MAClF,OAAO;EAGT,OAAOI,QAAQD,YAAY;CAC7B;;;;CAKA,OAAOE,SAA2B;EAChC,OAAO,IAAI,KAAK;CAClB;AACF;;;;;;;;;;;;;;;;;;;;;;;;ACrDA,IAAaC,gBAAb,MAA2B;;;;;CAKzBC,YAAYC,YAAoCC,UAAiD;EAC/F,IAAI,OAAOD,eAAe,UAAU;GAClC,IAAIE,SAASF,WAAWG,QAAQ,GAAG;GAEnC,IAAID,WAAW,MAAMF,WAAWI,SAAS,MAAMF,QAAQ;IACrDA,UAAU;IACV,uBAAO,IAAIG,KAAKL,WAAWM,MAAM,GAAGJ,MAAM,IAAI,MAAMF,WAAWM,MAAMJ,MAAM,CAAC;GAC9E;GACA,OAAO,IAAIG,KAAKL,UAAU;EAC5B,OAAO,IAAI,OAAOA,eAAe,UAC/B,OAAO,IAAIK,KAAKL,UAAU;OACrB,IAAIA,eAAe,QAAQA,eAAeO,QAG/C,OAAOP;OAEP,OAAO;CAEX;;;;;CAMAQ,UAAUC,MAAYR,UAAmD;EAEvE,IAAIQ,gBAAgBJ,QAAQ,CAACK,MAAMD,IAAI,GACrC,OAAOA,KAAKE,YAAY;OAExB,OAAO;CAEX;;;;CAKA,OAAOC,SAAwB;EAC7B,OAAO,IAAI,KAAK;CAClB;AACF;;;ACxEA,SAASC,SAASC,OAAe;CAC/B,OAAOA,UAAUA,SAASA,UAAUC,YAAYD,UAAU;AAC5D;;;;;;;;;;;;;;;;;;;;;;;AA+BA,IAAaE,kBAAb,MAA6B;;;;;CAK3BC,YAAYC,YAAgDC,UAAmD;EAC7G,IAAID,eAAe,MAAMA,eAAe,QAAQA,eAAeE,QAC7D,OAAO;OACF;GACL,MAAMC,cAAcC,OAAOJ,UAAU;GAErC,OAAOL,SAASQ,WAAW,IAAIA,cAAc;EAC/C;CACF;;;;CAKAE,UAAUC,cAAkDL,UAAmD;EAC7G,IAAIK,iBAAiB,MAAMA,iBAAiB,QAAQA,iBAAiBJ,QACnE,OAAO;OACF;GACL,MAAMC,cAAcC,OAAOE,YAAY;GAEvC,OAAOX,SAASQ,WAAW,IAAIA,cAAc;EAC/C;CACF;;;;CAKA,OAAOI,SAA0B;EAC/B,OAAO,IAAI,KAAK;CAClB;AACF;;;;;;;;;;;;;;;;;;;;;;;;ACxCA,IAAaC,kBAAb,MAA6B;;;;;CAK3BC,YAAYC,YAAqBC,UAAmD;EAClF,OAAO,CAACD,cAAcA,eAAe,KAAK,OAAOE,OAAOF,UAAU;CACpE;;;;CAIAG,UAAUC,cAAuBH,UAAmD;EAClF,OAAO,CAACG,gBAAgBA,iBAAiB,KAAK,OAAOF,OAAOE,YAAY;CAC1E;;;;CAKA,OAAOC,SAA0B;EAC/B,OAAO,IAAI,KAAK;CAClB;AACF"}

package/dist/unpkg/prod/serializer.js

@@ -1,8 +1,8 @@
-import { r as initializeDeferredDecorator, t as decorateFieldV2 } from "./runtime--fcdnjmJ-DMTJ0Kb3.js";
+import { r as initializeDeferredDecorator, t as decorateFieldV2 } from "./runtime--fcdnjmJ-5yaSpa-d.js";
 import EmberObject from "@ember/object";
 import * as s from "@ember/service";
 
-//#region src/serializer.ts
+// src/serializer.ts
 /**
 ## Overview
 
@@ -23,6 +23,42 @@ Data received from an API response is **normalized** into
 by WarpDrive), while data sent to an API is **serialized**
 into the format the API expects.
 
+### Why It's Legacy
+
+The Serializer pattern was designed to transform data between your API's format and the
+{json:api} format the legacy store works with:
+
+- `store.serializerFor` resolves a serializer by resource type at runtime, looking up
+`serializer:<type>` and then `serializer:application` through Ember's owner, though an
+API's format more often varies per API version than per resource type (see Serializer
+Resolution below).
+- Every response is converted into {json:api} before it reaches the cache, whatever format
+the API actually uses.
+- The provided serializer classes extend `EmberObject`, which, together with the owner
+lookup, ties the pattern to Ember.
+
+### Modern Alternative
+
+Use [Handlers](/api/@warp-drive/core/request/types/Handler) with the {@link RequestManager}.
+Modern ***Warp*Drive**:
+
+- normalizes a payload inside a handler when it needs transforming, using plain functions
+and helpers such as `dasherize` and `singularize` from `@warp-drive/utilities/string`
+- lets you pick a cache that understands your API's format natively, such as `JSONAPICache`
+from `@warp-drive/json-api` for {json:api}, or write your own that implements the Cache
+interface
+
+For an alternative modern pattern to Serializers, see the
+[Request Handlers Guide](/guides/the-manual/requests/handlers).
+
+### Setup
+
+Serializers run inside the `LegacyNetworkHandler` from
+[`@warp-drive/legacy/compat`](/api/@warp-drive/legacy/compat/). A store created with
+`useLegacyStore` adds it unless `linksMode` is `true`; a store you build yourself must add it
+to its `RequestManager`, as shown in
+[Configure the Store](/guides/configuration/legacy-package-setup/setup/universal.md#configure-the-store).
+
 ### Implementing a Serializer
 
 There are only two required serializer methods, one for
@@ -106,6 +142,8 @@ by these serializers.
 It is recommended that apps write their own serializer to best suit the needs of their API and
 application.
 
+@summary Legacy serializer layer that converts data between an API's format and JSON:API for the adapter-based
+request flow.
 @module
 */
 const service = s.service ?? s.inject;
@@ -126,6 +164,8 @@ And you can optionally override the following methods:
 
 For an example implementation, see the included {@link JSONSerializer}.
 
+@summary Legacy abstract base class for serializers that normalize API responses into JSON:API and serialize
+records into the API's request format.
 @class Serializer
 @public
 */
@@ -240,6 +280,5 @@ var Serializer = class extends EmberObject {
 	}
 };
 
-//#endregion
 export { Serializer };
 //# sourceMappingURL=serializer.js.map

package/dist/unpkg/prod/serializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.js","names":["EmberObject","s","g","i","service","inject","Serializer","prototype","store","normalize","_typeClass","hash"],"sources":["../../../src/serializer.ts"],"sourcesContent":["/**\n  ## Overview\n\n  :::danger\n    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.\n    If starting a new app or thinking of implementing a new serializer, consider writing a\n    {@link Handler} instead to be used with the {@link RequestManager}\n  :::\n\n  In order to properly manage and present your data, WarpDrive\n  needs to understand the structure of data it receives.\n\n  `Serializers` convert data between the server's API format and\n  the format WarpDrive understands.\n\n  Data received from an API response is **normalized** into\n  [{json:api}](https://jsonapi.org/) (the format used internally\n  by WarpDrive), while data sent to an API is **serialized**\n  into the format the API expects.\n\n  ### Implementing a Serializer\n\n  There are only two required serializer methods, one for\n  normalizing data from the server API format into {json:api}, and\n  another for serializing records via `Snapshots` into the expected\n  server API format.\n\n  To implement a serializer, export a class that conforms to the structure\n  described by {@link MinimumSerializerInterface}\n  from the `app/serializers/` directory. An example is below.\n\n  ```ts\n  import EmberObject from '@ember/object';\n\n  export default class ApplicationSerializer extends EmberObject {\n    normalizeResponse(store, schema, rawPayload) {\n      return rawPayload;\n    }\n\n    serialize(snapshot, options) {\n      const serializedResource = {\n        id: snapshot.id,\n        type: snapshot.modelName,\n        attributes: snapshot.attributes()\n      };\n\n      return serializedResource;\n    }\n  }\n ```\n\n\n  ### Serializer Resolution\n\n  `store.serializerFor(name)` will lookup serializers defined in\n  `app/serializers/` and return an instance. If no serializer is found, an\n  error will be thrown.\n\n  `serializerFor` first attempts to find a serializer with an exact match on `name`,\n  then falls back to checking for the presence of a serializer named `application`.\n\n  ```ts\n  store.serializerFor('author');\n\n  // lookup paths (in order) =>\n  //   app/serializers/author.js\n  //   app/serializers/application.js\n  ```\n\n  Most requests in `@warp-drive/legacy` are made with respect to a particular `type` (or `modelName`)\n  (e.g., \"get me the full collection of **books**\" or \"get me the **employee** whose id is 37\"). We\n  refer to this as the **primary** resource `type`.\n\n  Typically `serializerFor` will be used to find a serializer with a name matching that of the primary\n  resource `type` for the request, falling back to the `application` serializer for those types that\n  do not have a defined serializer. This is often described as a `per-model` or `per-type` strategy\n  for defining serializers. However, because APIs rarely format payloads per-type but rather\n  per-API-version, this may not be a desired strategy.\n\n  It is recommended that applications define only a single `application` adapter and serializer\n  where possible.\n\n  If you have multiple API formats and the per-type strategy is not viable, one strategy is to\n  write an `application` adapter and serializer that make use of `options` to specify the desired\n  format when making a request.\n\n  ### Using a Serializer\n\n  Any serializer in `app/serializers/` can be looked up by `name` using `store.serializerFor(name)`.\n\n  ### Default Serializers\n\n  For applications whose APIs are *very close to* or *exactly* the **REST** format or **JSON:API**\n  format the `@warp-drive/legacy/serializer` package contains implementations these applications can\n  extend. It also contains a simple `JSONSerializer` for serializing to/from very basic JSON objects.\n\n  Many applications will find writing their own serializer to be more performant and less\n  complex than extending these classes even when their API format is very close to that expected\n  by these serializers.\n\n  It is recommended that apps write their own serializer to best suit the needs of their API and\n  application.\n\n  @module\n*/\nimport EmberObject from '@ember/object';\nimport * as s from '@ember/service';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestManager, Store } from '@warp-drive/core';\n// oxlint-disable-next-line no-unused-vars\nimport type { Handler } from '@warp-drive/core/request';\nimport type { ModelSchema } from '@warp-drive/core/types';\nimport type { EmptyResourceDocument, SingleResourceDocument } from '@warp-drive/core/types/spec/json-api-raw';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { MinimumSerializerInterface } from './compat';\n// oxlint-disable-next-line no-unused-vars\nimport type { JSONSerializer } from './serializer/json';\n\nconst service = s.service ?? s.inject;\n\n/**\n  > ⚠️ CAUTION you likely want the docs for {@link MinimumSerializerInterface}\n  > as extending this abstract class is unnecessary.\n\n  `Serializer` is an abstract base class that you may override in your\n  application to customize it for your backend. The minimum set of methods\n  that you should implement is:\n\n    * `normalizeResponse()`\n    * `serialize()`\n\n  And you can optionally override the following methods:\n\n    * `normalize()`\n\n  For an example implementation, see the included {@link JSONSerializer}.\n\n  @class Serializer\n  @public\n*/\n\nexport class Serializer extends EmberObject {\n  /**\n    The `store` property is the application's `store` that contains\n    all records. It can be used to look up serializers for other model\n    types that may be nested inside the payload response.\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      extractRelationship(relationshipModelName, relationshipHash) {\n        let modelClass = this.store.modelFor(relationshipModelName);\n        let relationshipSerializer = this.store.serializerFor(relationshipModelName);\n        return relationshipSerializer.normalize(modelClass, relationshipHash);\n      }\n    });\n    ```\n\n    @public\n  */\n  @service declare store: Store;\n\n  /**\n    The `normalizeResponse` method is used to normalize a payload from the\n    server to a JSON-API Document.\n\n    http://jsonapi.org/format/#document-structure\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      normalizeResponse(store, primaryModelClass, payload, id, requestType) {\n        if (requestType === 'findRecord') {\n          return this.normalize(primaryModelClass, payload);\n        } else {\n          return payload.reduce(function(documentHash, item) {\n            let { data, included } = this.normalize(primaryModelClass, item);\n            documentHash.included.push(...included);\n            documentHash.data.push(data);\n            return documentHash;\n          }, { data: [], included: [] })\n        }\n      }\n    });\n    ```\n\n    @since 1.13.0\n    @public\n    @param {Store} store\n    @param {Model} primaryModelClass\n    @param {Object} payload\n    @param {String|Number} id\n    @param {String} requestType\n    @return {Object} JSON-API Document\n  */\n\n  /**\n    The `serialize` method is used when a record is saved in order to convert\n    the record into the form that your external data source expects.\n\n    `serialize` takes an optional `options` hash with a single option:\n\n    - `includeId`: If this is `true`, `serialize` should include the ID\n      in the serialized object it builds.\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      serialize(snapshot, options) {\n        let json = {\n          id: snapshot.id\n        };\n\n        snapshot.eachAttribute((key, attribute) => {\n          json[key] = snapshot.attr(key);\n        });\n\n        snapshot.eachRelationship((key, relationship) => {\n          if (relationship.kind === 'belongsTo') {\n            json[key] = snapshot.belongsTo(key, { id: true });\n          } else if (relationship.kind === 'hasMany') {\n            json[key] = snapshot.hasMany(key, { ids: true });\n          }\n        });\n\n        return json;\n      },\n    });\n    ```\n\n    @public\n    @param {Snapshot} snapshot\n    @param {Object} [options]\n    @return {Object}\n  */\n\n  /**\n    The `normalize` method is used to convert a payload received from your\n    external data source into the normalized form `store.push()` expects. You\n    should override this method, munge the hash and return the normalized\n    payload.\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      normalize(modelClass, resourceHash) {\n        let data = {\n          id:            resourceHash.id,\n          type:          modelClass.modelName,\n          attributes:    resourceHash\n        };\n        return { data: data };\n      }\n    })\n    ```\n\n    @public\n    @param _typeClass - the model class the hash is being normalized for\n    @param hash - the raw payload hash to normalize\n    @return the normalized resource document\n  */\n  normalize(_typeClass: ModelSchema, hash: Record<string, unknown>): SingleResourceDocument | EmptyResourceDocument {\n    return hash as unknown as SingleResourceDocument;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwHA,MAAMI,UAAUH,EAAEG,WAAWH,EAAEI;;;;;;;;;;;;;;;;;;;;;AAuB/B,IAAaC,aAAb,cAAgCN,YAAY;CAAA;EAAAE,gBAAA,KAAAK,WAAA,SAAA,CAoBzCH,OAAO,CAAA;CAAA;CAAA,UAAAD,4BAAA,MAAA,OAAA,GAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGRM,UAAUC,YAAyBC,MAA+E;EAChH,OAAOA;CACT;AACF"}
+{"version":3,"file":"serializer.js","names":["EmberObject","s","g","i","service","inject","Serializer","prototype","store","normalize","_typeClass","hash","i"],"sources":["../../../src/serializer.ts"],"sourcesContent":["/**\n  ## Overview\n\n  :::danger\n    ⚠️ **This is LEGACY documentation** for a feature that is no longer encouraged to be used.\n    If starting a new app or thinking of implementing a new serializer, consider writing a\n    {@link Handler} instead to be used with the {@link RequestManager}\n  :::\n\n  In order to properly manage and present your data, WarpDrive\n  needs to understand the structure of data it receives.\n\n  `Serializers` convert data between the server's API format and\n  the format WarpDrive understands.\n\n  Data received from an API response is **normalized** into\n  [{json:api}](https://jsonapi.org/) (the format used internally\n  by WarpDrive), while data sent to an API is **serialized**\n  into the format the API expects.\n\n  ### Why It's Legacy\n\n  The Serializer pattern was designed to transform data between your API's format and the\n  {json:api} format the legacy store works with:\n\n  - `store.serializerFor` resolves a serializer by resource type at runtime, looking up\n    `serializer:<type>` and then `serializer:application` through Ember's owner, though an\n    API's format more often varies per API version than per resource type (see Serializer\n    Resolution below).\n  - Every response is converted into {json:api} before it reaches the cache, whatever format\n    the API actually uses.\n  - The provided serializer classes extend `EmberObject`, which, together with the owner\n    lookup, ties the pattern to Ember.\n\n  ### Modern Alternative\n\n  Use [Handlers](/api/@warp-drive/core/request/types/Handler) with the {@link RequestManager}.\n  Modern ***Warp*Drive**:\n\n  - normalizes a payload inside a handler when it needs transforming, using plain functions\n    and helpers such as `dasherize` and `singularize` from `@warp-drive/utilities/string`\n  - lets you pick a cache that understands your API's format natively, such as `JSONAPICache`\n    from `@warp-drive/json-api` for {json:api}, or write your own that implements the Cache\n    interface\n\n  For an alternative modern pattern to Serializers, see the\n  [Request Handlers Guide](/guides/the-manual/requests/handlers).\n\n  ### Setup\n\n  Serializers run inside the `LegacyNetworkHandler` from\n  [`@warp-drive/legacy/compat`](/api/@warp-drive/legacy/compat/). A store created with\n  `useLegacyStore` adds it unless `linksMode` is `true`; a store you build yourself must add it\n  to its `RequestManager`, as shown in\n  [Configure the Store](/guides/configuration/legacy-package-setup/setup/universal.md#configure-the-store).\n\n  ### Implementing a Serializer\n\n  There are only two required serializer methods, one for\n  normalizing data from the server API format into {json:api}, and\n  another for serializing records via `Snapshots` into the expected\n  server API format.\n\n  To implement a serializer, export a class that conforms to the structure\n  described by {@link MinimumSerializerInterface}\n  from the `app/serializers/` directory. An example is below.\n\n  ```ts\n  import EmberObject from '@ember/object';\n\n  export default class ApplicationSerializer extends EmberObject {\n    normalizeResponse(store, schema, rawPayload) {\n      return rawPayload;\n    }\n\n    serialize(snapshot, options) {\n      const serializedResource = {\n        id: snapshot.id,\n        type: snapshot.modelName,\n        attributes: snapshot.attributes()\n      };\n\n      return serializedResource;\n    }\n  }\n ```\n\n\n  ### Serializer Resolution\n\n  `store.serializerFor(name)` will lookup serializers defined in\n  `app/serializers/` and return an instance. If no serializer is found, an\n  error will be thrown.\n\n  `serializerFor` first attempts to find a serializer with an exact match on `name`,\n  then falls back to checking for the presence of a serializer named `application`.\n\n  ```ts\n  store.serializerFor('author');\n\n  // lookup paths (in order) =>\n  //   app/serializers/author.js\n  //   app/serializers/application.js\n  ```\n\n  Most requests in `@warp-drive/legacy` are made with respect to a particular `type` (or `modelName`)\n  (e.g., \"get me the full collection of **books**\" or \"get me the **employee** whose id is 37\"). We\n  refer to this as the **primary** resource `type`.\n\n  Typically `serializerFor` will be used to find a serializer with a name matching that of the primary\n  resource `type` for the request, falling back to the `application` serializer for those types that\n  do not have a defined serializer. This is often described as a `per-model` or `per-type` strategy\n  for defining serializers. However, because APIs rarely format payloads per-type but rather\n  per-API-version, this may not be a desired strategy.\n\n  It is recommended that applications define only a single `application` adapter and serializer\n  where possible.\n\n  If you have multiple API formats and the per-type strategy is not viable, one strategy is to\n  write an `application` adapter and serializer that make use of `options` to specify the desired\n  format when making a request.\n\n  ### Using a Serializer\n\n  Any serializer in `app/serializers/` can be looked up by `name` using `store.serializerFor(name)`.\n\n  ### Default Serializers\n\n  For applications whose APIs are *very close to* or *exactly* the **REST** format or **JSON:API**\n  format the `@warp-drive/legacy/serializer` package contains implementations these applications can\n  extend. It also contains a simple `JSONSerializer` for serializing to/from very basic JSON objects.\n\n  Many applications will find writing their own serializer to be more performant and less\n  complex than extending these classes even when their API format is very close to that expected\n  by these serializers.\n\n  It is recommended that apps write their own serializer to best suit the needs of their API and\n  application.\n\n  @summary Legacy serializer layer that converts data between an API's format and JSON:API for the adapter-based\n  request flow.\n  @module\n*/\nimport EmberObject from '@ember/object';\nimport * as s from '@ember/service';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestManager, Store } from '@warp-drive/core';\n// oxlint-disable-next-line no-unused-vars\nimport type { Handler } from '@warp-drive/core/request';\nimport type { ModelSchema } from '@warp-drive/core/types';\nimport type { EmptyResourceDocument, SingleResourceDocument } from '@warp-drive/core/types/spec/json-api-raw';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { MinimumSerializerInterface } from './compat';\n// oxlint-disable-next-line no-unused-vars\nimport type { JSONSerializer } from './serializer/json';\n\nconst service = s.service ?? s.inject;\n\n/**\n  > ⚠️ CAUTION you likely want the docs for {@link MinimumSerializerInterface}\n  > as extending this abstract class is unnecessary.\n\n  `Serializer` is an abstract base class that you may override in your\n  application to customize it for your backend. The minimum set of methods\n  that you should implement is:\n\n    * `normalizeResponse()`\n    * `serialize()`\n\n  And you can optionally override the following methods:\n\n    * `normalize()`\n\n  For an example implementation, see the included {@link JSONSerializer}.\n\n  @summary Legacy abstract base class for serializers that normalize API responses into JSON:API and serialize\n  records into the API's request format.\n  @class Serializer\n  @public\n*/\n\nexport class Serializer extends EmberObject {\n  /**\n    The `store` property is the application's `store` that contains\n    all records. It can be used to look up serializers for other model\n    types that may be nested inside the payload response.\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      extractRelationship(relationshipModelName, relationshipHash) {\n        let modelClass = this.store.modelFor(relationshipModelName);\n        let relationshipSerializer = this.store.serializerFor(relationshipModelName);\n        return relationshipSerializer.normalize(modelClass, relationshipHash);\n      }\n    });\n    ```\n\n    @public\n  */\n  @service declare store: Store;\n\n  /**\n    The `normalizeResponse` method is used to normalize a payload from the\n    server to a JSON-API Document.\n\n    http://jsonapi.org/format/#document-structure\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      normalizeResponse(store, primaryModelClass, payload, id, requestType) {\n        if (requestType === 'findRecord') {\n          return this.normalize(primaryModelClass, payload);\n        } else {\n          return payload.reduce(function(documentHash, item) {\n            let { data, included } = this.normalize(primaryModelClass, item);\n            documentHash.included.push(...included);\n            documentHash.data.push(data);\n            return documentHash;\n          }, { data: [], included: [] })\n        }\n      }\n    });\n    ```\n\n    @since 1.13.0\n    @public\n    @param {Store} store\n    @param {Model} primaryModelClass\n    @param {Object} payload\n    @param {String|Number} id\n    @param {String} requestType\n    @return {Object} JSON-API Document\n  */\n\n  /**\n    The `serialize` method is used when a record is saved in order to convert\n    the record into the form that your external data source expects.\n\n    `serialize` takes an optional `options` hash with a single option:\n\n    - `includeId`: If this is `true`, `serialize` should include the ID\n      in the serialized object it builds.\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      serialize(snapshot, options) {\n        let json = {\n          id: snapshot.id\n        };\n\n        snapshot.eachAttribute((key, attribute) => {\n          json[key] = snapshot.attr(key);\n        });\n\n        snapshot.eachRelationship((key, relationship) => {\n          if (relationship.kind === 'belongsTo') {\n            json[key] = snapshot.belongsTo(key, { id: true });\n          } else if (relationship.kind === 'hasMany') {\n            json[key] = snapshot.hasMany(key, { ids: true });\n          }\n        });\n\n        return json;\n      },\n    });\n    ```\n\n    @public\n    @param {Snapshot} snapshot\n    @param {Object} [options]\n    @return {Object}\n  */\n\n  /**\n    The `normalize` method is used to convert a payload received from your\n    external data source into the normalized form `store.push()` expects. You\n    should override this method, munge the hash and return the normalized\n    payload.\n\n    Example:\n\n    ```js\n    Serializer.extend({\n      normalize(modelClass, resourceHash) {\n        let data = {\n          id:            resourceHash.id,\n          type:          modelClass.modelName,\n          attributes:    resourceHash\n        };\n        return { data: data };\n      }\n    })\n    ```\n\n    @public\n    @param _typeClass - the model class the hash is being normalized for\n    @param hash - the raw payload hash to normalize\n    @return the normalized resource document\n  */\n  normalize(_typeClass: ModelSchema, hash: Record<string, unknown>): SingleResourceDocument | EmptyResourceDocument {\n    return hash as unknown as SingleResourceDocument;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8JA,MAAMI,UAAUH,EAAEG,WAAWH,EAAEI;;;;;;;;;;;;;;;;;;;;;;;AAyB/B,IAAaC,aAAb,cAAgCN,YAAY;CAAA;EAAAE,gBAAA,KAAAK,WAAA,SAAA,CAoBzCH,OAAO,CAAA;CAAA;CAAA,UAAAD,4BAAA,MAAA,OAAA,GAAA,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGRM,UAAUC,YAAyBC,MAA+E;EAChH,OAAOA;CACT;AACF"}

package/dist/unpkg/{prod-deprecated/store-0L2CkYzh.js → prod/store-BsSkzWgk.js}

@@ -1,11 +1,11 @@
-import { n as normalizeModelName } from "./util-CQQdHX3n.js";
-import { t as isMaybeIdentifier } from "./utils-BMI_JwFP.js";
+import { n as normalizeModelName } from "./util-CI7b4vAE.js";
+import { t as isMaybeIdentifier } from "./utils-_O0MjUTU.js";
 import { assertPrivateStore, constructResource, ensureStringId, recordIdentifierFor } from "@warp-drive/core/store/-private";
 import { getOrSetGlobal } from "@warp-drive/core/types/-private";
 import { defineSignal } from "@warp-drive/core/signals/-leaked";
 import { SkipCache } from "@warp-drive/core/types/request";
 
-//#region src/store/-private.ts
+// src/store/-private.ts
 function preloadData(store, identifier, preload) {
 	const jsonPayload = {};
 	const fields = store.schema.fields(identifier);
@@ -269,14 +269,21 @@ var ShimModelClass = class {
 	}
 };
 
-//#endregion
-//#region src/store.ts
+// src/store.ts
+/**
+* @module
+* @summary Legacy `restoreDeprecatedStoreBehaviors`, which restores the adapter-based `findRecord`, `findAll`, `query`,
+* `saveRecord` and related methods onto a `Store` class.
+*/
 /**
 * Restores the deprecated `findRecord`/`findAll`/`query`/`queryRecord`/
 * `findBelongsTo`/`findHasMany`/`createRecord`/`deleteRecord`/`saveRecord`
 * legacy-network-layer implementations of these methods onto the given
 * `Store` subclass, for apps that have not yet migrated to the
 * `RequestManager`-based equivalents.
+*
+* @summary Legacy opt-in that restores the adapter-based `findRecord`, `findAll`, `query`, `saveRecord`, and related
+* methods onto a `Store` class.
 */
 function restoreDeprecatedStoreBehaviors(StoreKlass) {
 	StoreKlass.prototype.findRecord = function(resource, id, options) {
@@ -387,6 +394,5 @@ function upgradeInstanceCaches(cache) {
 	return withReferences;
 }
 
-//#endregion
 export { restoreDeprecatedStoreBehaviors as t };
-//# sourceMappingURL=store-0L2CkYzh.js.map
+//# sourceMappingURL=store-BsSkzWgk.js.map

package/dist/unpkg/{prod-deprecated/store-0L2CkYzh.js.map → prod/store-BsSkzWgk.js.map}

@@ -1 +1 @@
-{"version":3,"file":"store-0L2CkYzh.js","names":["defineSignal","assertPrivateStore","ensureStringId","recordIdentifierFor","getOrSetGlobal","preloadData","store","identifier","preload","jsonPayload","schemas","schema","fields","Object","keys","forEach","key","preloadValue","field","get","kind","relationships","preloadRelationship","attributes","cache","hasRecord","Boolean","_instanceCache","peek","upsert","relatedType","type","data","map","value","_convertPreloadRelationshipToJSON","id","_resourceIsFullDeleted","isDeletionCommitted","isNew","isDeleted","resourceIsFullyDeleted","instanceCache","RecordReference","___token","___identifier","constructor","notifications","subscribe","_","bucket","notifiedKey","_ref","destroy","unsubscribe","remoteType","push","objectOrPromise","Promise","resolve","then","peekRecord","load","findRecord","reload","prototype","AvailableShims","WeakMap","getShimClass","modelName","shims","create","set","shim","undefined","ShimModelClass","__store","Map","fieldSchemas","attrs","relationshipsByName","rels","eachAttribute","callback","binding","call","eachRelationship","eachTransformedAttribute","assertPrivateStore","constructResource","ensureStringId","recordIdentifierFor","storeFor","SkipCache","isMaybeIdentifier","normalizeModelName","getShimClass","preloadData","RecordReference","resourceIsFullyDeleted","restoreDeprecatedStoreBehaviors","StoreKlass","prototype","findRecord","resource","id","options","type","normalizedId","identifier","cacheKeyManager","getOrCreateRecordIdentifier","preload","_instanceCache","recordIsLoaded","reload","_join","promise","request","op","data","record","cacheOptions","then","document","content","findAll","query","queryRecord","getReference","resourceIdentifier","arguments","length","cache","upgradeInstanceCaches","__instances","reference","get","set","modelFor","saveRecord","Promise","reject","Error","resolve","operation","isNew","isDeleted","records","withReferences","WeakMap"],"sources":["../../../src/store/-private.ts","../../../src/store.ts"],"sourcesContent":["import type { NotificationType } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { defineSignal } from '@warp-drive/core/signals/-leaked';\nimport {\n  assertPrivateStore,\n  ensureStringId,\n  type InstanceCache,\n  recordIdentifierFor,\n} from '@warp-drive/core/store/-private';\nimport { getOrSetGlobal } from '@warp-drive/core/types/-private';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { NewResourceKey, ResourceKey } from '@warp-drive/core/types/identifier';\nimport type { Value } from '@warp-drive/core/types/json/raw';\nimport type { OpaqueRecordInstance, TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport type {\n  LegacyAttributeField,\n  LegacyRelationshipField,\n  LegacyRelationshipField as RelationshipSchema,\n} from '@warp-drive/core/types/schema/fields';\nimport type {\n  ExistingResourceIdentifierObject,\n  ExistingResourceObject,\n  InnerRelationshipDocument,\n  SingleResourceDocument,\n} from '@warp-drive/core/types/spec/json-api-raw';\n\nimport type { Store } from '../store.ts';\n\n/*\n    When a find request is triggered on the store, the user can optionally pass in\n    attributes and relationships to be preloaded. These are meant to behave as if they\n    came back from the server, except the user obtained them out of band and is informing\n    the store of their existence. The most common use case is for supporting client side\n    nested URLs, such as `/posts/1/comments/2` so the user can do\n    `store.findRecord('comment', 2, { preload: { post: 1 } })` without having to fetch the post.\n\n    Preloaded data can be attributes and relationships passed in either as IDs or as actual\n    models.\n  */\ntype PreloadRelationshipValue = OpaqueRecordInstance | string;\nexport function preloadData(store: Store, identifier: NewResourceKey, preload: Record<string, Value>): void {\n  const jsonPayload: Partial<ExistingResourceObject> = {};\n  //TODO(Igor) consider the polymorphic case\n  const schemas = store.schema;\n  const fields = schemas.fields(identifier);\n  Object.keys(preload).forEach((key) => {\n    const preloadValue = preload[key];\n\n    const field = fields.get(key);\n    if (field && (field.kind === 'hasMany' || field.kind === 'belongsTo')) {\n      if (!jsonPayload.relationships) {\n        jsonPayload.relationships = {};\n      }\n      jsonPayload.relationships[key] = preloadRelationship(field, preloadValue);\n    } else {\n      if (!jsonPayload.attributes) {\n        jsonPayload.attributes = {};\n      }\n      jsonPayload.attributes[key] = preloadValue;\n    }\n  });\n  const cache = store.cache;\n  assertPrivateStore(store);\n  const hasRecord = Boolean(store._instanceCache.peek(identifier));\n  cache.upsert(identifier, jsonPayload, hasRecord);\n}\n\nfunction preloadRelationship(\n  schema: RelationshipSchema,\n  preloadValue: PreloadRelationshipValue | null | Array<PreloadRelationshipValue>\n): InnerRelationshipDocument<ExistingResourceIdentifierObject> {\n  const relatedType = schema.type;\n\n  if (schema.kind === 'hasMany') {\n    assert('You need to pass in an array to set a hasMany property on a record', Array.isArray(preloadValue));\n    return { data: preloadValue.map((value) => _convertPreloadRelationshipToJSON(value, relatedType)) };\n  }\n\n  assert('You should not pass in an array to set a belongsTo property on a record', !Array.isArray(preloadValue));\n  return { data: preloadValue ? _convertPreloadRelationshipToJSON(preloadValue, relatedType) : null };\n}\n\n/*\n  findRecord('user', '1', { preload: { friends: ['1'] }});\n  findRecord('user', '1', { preload: { friends: [record] }});\n*/\nfunction _convertPreloadRelationshipToJSON(\n  value: OpaqueRecordInstance | string,\n  type: string\n): ExistingResourceIdentifierObject {\n  if (typeof value === 'string' || typeof value === 'number') {\n    return { type, id: ensureStringId(value) };\n  }\n  // TODO if not a record instance assert it's an identifier\n  // and allow identifiers to be used\n  return recordIdentifierFor(value) as ExistingResourceIdentifierObject;\n}\n\nexport interface BaseFinderOptions {\n  reload?: boolean;\n  backgroundReload?: boolean;\n  include?: string | string[];\n  adapterOptions?: Record<string, unknown>;\n}\nexport interface FindRecordOptions extends BaseFinderOptions {\n  /**\n   * Data to preload into the store before the request is made.\n   * This feature is *highly* discouraged and has no corresponding\n   * feature when using builders and handlers.\n   *\n   * Excepting relationships: the data should be in the form of a\n   * JSON object where the keys are fields on the record and the value\n   * is the raw value to be added to the cache.\n   *\n   * Relationships can either be provided as string IDs from which\n   * an identifier will be built base upon the relationship's expected\n   * resource type, or be record instances from which the identifier\n   * will be extracted.\n   *\n   */\n  preload?: Record<string, Value>;\n}\n\nexport type QueryOptions = {\n  [K in string | 'adapterOptions']?: K extends 'adapterOptions' ? Record<string, unknown> : unknown;\n};\n\nexport type FindAllOptions = BaseFinderOptions;\nexport type LegacyResourceQuery = {\n  include?: string | string[];\n  [key: string]: Value | undefined;\n};\n\nexport type KeyOrString<T> = keyof T & string extends never ? string : keyof T & string;\n\n/**\n * Minimum subset of static schema methods and properties on the\n * \"model\" class.\n *\n * Only used when using the legacy schema-service implementation\n * for @ember-data/model or when wrapping schema for legacy\n * Adapters/Serializers.\n *\n */\nexport interface ModelSchema<T = unknown> {\n  modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;\n  fields: Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'>;\n  attributes: Map<KeyOrString<T>, LegacyAttributeField>;\n  relationshipsByName: Map<KeyOrString<T>, LegacyRelationshipField>;\n  eachAttribute<K extends KeyOrString<T>>(\n    callback: (this: ModelSchema<T>, key: K, attribute: LegacyAttributeField) => void,\n    binding?: T\n  ): void;\n  eachRelationship<K extends KeyOrString<T>>(\n    callback: (this: ModelSchema<T>, key: K, relationship: LegacyRelationshipField) => void,\n    binding?: T\n  ): void;\n  eachTransformedAttribute<K extends KeyOrString<T>>(\n    callback: (this: ModelSchema<T>, key: K, type: string | null) => void,\n    binding?: T\n  ): void;\n}\n\nfunction _resourceIsFullDeleted(identifier: ResourceKey, cache: Cache): boolean {\n  return cache.isDeletionCommitted(identifier) || (cache.isNew(identifier) && cache.isDeleted(identifier));\n}\n\nexport function resourceIsFullyDeleted(instanceCache: InstanceCache, identifier: ResourceKey): boolean {\n  const cache = instanceCache.cache;\n  return !cache || _resourceIsFullDeleted(identifier, cache);\n}\n\n/**\n   A `RecordReference` is a low-level API that allows users and\n   addon authors to perform meta-operations on a record.\n\n   @hideconstructor\n   @public\n*/\nexport class RecordReference {\n  /** @internal */\n  declare private store: Store;\n  // unsubscribe token given to us by the notification manager\n  /** @internal */\n  private ___token!: object;\n  /** @internal */\n  private ___identifier: ResourceKey;\n  /** @internal */\n  declare private _ref: number;\n\n  constructor(store: Store, identifier: ResourceKey) {\n    this.store = store;\n    this.___identifier = identifier;\n    this.___token = store.notifications.subscribe(\n      identifier,\n      (_: ResourceKey, bucket: NotificationType, notifiedKey?: string) => {\n        if (bucket === 'identity' || (bucket === 'attributes' && notifiedKey === 'id')) {\n          this._ref++;\n        }\n      }\n    );\n  }\n\n  /** @internal */\n  destroy(): void {\n    this.store.notifications.unsubscribe(this.___token);\n  }\n\n  get type(): string {\n    return this.identifier().type;\n  }\n\n  /**\n     The `id` of the record that this reference refers to.\n\n     Together, the `type` and `id` properties form a composite key for\n     the identity map.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     userRef.id(); // '1'\n     ```\n\n    @public\n    @return The id of the record.\n  */\n  id(): string | null {\n    // oxlint-disable-next-line no-unused-expressions\n    this._ref; // consume the tracked prop\n    return this.___identifier.id;\n  }\n\n  /**\n     The `identifier` of the record that this reference refers to.\n\n     Together, the `type` and `id` properties form a composite key for\n     the identity map.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     userRef.identifier(); // '1'\n     ```\n\n    @public\n    @return The identifier of the record.\n  */\n  identifier(): ResourceKey {\n    return this.___identifier;\n  }\n\n  /**\n     How the reference will be looked up when it is loaded. Currently\n     this always returns `identity` to signify that a record will be\n     loaded by its `type` and `id`.\n\n     Example\n\n     ```javascript\n     const userRef = store.getReference('user', 1);\n\n     userRef.remoteType(); // 'identity'\n     ```\n\n     @public\n  */\n  remoteType(): 'identity' {\n    return 'identity';\n  }\n\n  /**\n    This API allows you to provide a reference with new data. The\n    simplest usage of this API is similar to `store.push`: you provide a\n    normalized hash of data and the object represented by the reference\n    will update.\n\n    If you pass a promise to `push`, WarpDrive will not ask the adapter\n    for the data if another attempt to fetch it is made in the\n    interim. When the promise resolves, the underlying object is updated\n    with the new data, and the promise returned by *this function* is resolved\n    with that object.\n\n    For example, `recordReference.push(promise)` will be resolved with a\n    record.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     // provide data for reference\n     userRef.push({\n       data: {\n         id: \"1\",\n         type: \"user\",\n         attributes: {\n           username: \"@user\"\n         }\n       }\n     }).then(function(user) {\n       userRef.value() === user;\n     });\n     ```\n\n    @public\n    @param objectOrPromise a JSON:API ResourceDocument or a promise resolving to one\n    @return a promise for the value (record or relationship)\n  */\n  push(objectOrPromise: SingleResourceDocument | Promise<SingleResourceDocument>): Promise<OpaqueRecordInstance> {\n    // TODO @deprecate pushing unresolved payloads\n    return Promise.resolve(objectOrPromise).then((data) => {\n      return this.store.push(data);\n    });\n  }\n\n  /**\n    If the entity referred to by the reference is already loaded, it is\n    present as `reference.value`. Otherwise the value returned by this function\n    is `null`.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     userRef.value(); // user\n     ```\n\n    @public\n    @return the record for this RecordReference\n  */\n  value(): OpaqueRecordInstance | null {\n    return this.store.peekRecord(this.___identifier);\n  }\n\n  /**\n     Triggers a fetch for the backing entity based on its `remoteType`\n     (see `remoteType` definitions per reference type).\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     // load user (via store.find)\n     userRef.load().then(...)\n     ```\n\n    @public\n    @return the record for this RecordReference\n  */\n  load(): Promise<unknown> {\n    const id = this.id();\n    if (id !== null) {\n      return this.store.findRecord(this.type, id);\n    }\n    assert(`Unable to fetch record of type ${this.type} without an id`);\n  }\n\n  /**\n     Reloads the record if it is already loaded. If the record is not\n     loaded it will load the record via `store.findRecord`\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     // or trigger a reload\n     userRef.reload().then(...)\n     ```\n\n    @public\n    @return the record for this RecordReference\n  */\n  reload(): Promise<unknown> {\n    const id = this.id();\n    if (id !== null) {\n      return this.store.findRecord(this.type, id, { reload: true });\n    }\n    assert(`Unable to fetch record of type ${this.type} without an id`);\n  }\n}\n\ndefineSignal(RecordReference.prototype, '_ref');\n\n// if modelFor turns out to be a bottleneck we should replace with a Map\n// and clear it during store teardown.\nconst AvailableShims = getOrSetGlobal('AvailableShims', new WeakMap<Store, Record<string, ShimModelClass>>());\n\nexport function getShimClass<T>(\n  store: Store,\n  modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string\n): ShimModelClass<T> {\n  let shims = AvailableShims.get(store);\n\n  if (!shims) {\n    shims = Object.create(null) as Record<string, ShimModelClass>;\n    AvailableShims.set(store, shims);\n  }\n\n  let shim = shims[modelName];\n  if (shim === undefined) {\n    shim = shims[modelName] = new ShimModelClass<unknown>(store, modelName);\n  }\n\n  return shim;\n}\n\n// Mimics the static apis of @ember-data/model\nexport class ShimModelClass<T = unknown> implements ModelSchema<T> {\n  declare __store: Store;\n  declare modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;\n  constructor(store: Store, modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string) {\n    this.__store = store;\n    this.modelName = modelName;\n  }\n\n  get fields(): Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'> {\n    const fields = new Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'>();\n    const fieldSchemas = this.__store.schema.fields({ type: this.modelName });\n\n    fieldSchemas.forEach((schema, key) => {\n      if (schema.kind === 'attribute' || schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        fields.set(key as KeyOrString<T>, schema.kind);\n      }\n    });\n\n    return fields;\n  }\n\n  get attributes(): Map<KeyOrString<T>, LegacyAttributeField> {\n    const attrs = new Map<KeyOrString<T>, LegacyAttributeField>();\n    const fields = this.__store.schema.fields({ type: this.modelName });\n\n    fields.forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        attrs.set(key as KeyOrString<T>, schema);\n      }\n    });\n\n    return attrs;\n  }\n\n  get relationshipsByName(): Map<KeyOrString<T>, LegacyRelationshipField> {\n    const rels = new Map<KeyOrString<T>, LegacyRelationshipField>();\n    const fields = this.__store.schema.fields({ type: this.modelName });\n\n    fields.forEach((schema, key) => {\n      if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        rels.set(key as KeyOrString<T>, schema);\n      }\n    });\n\n    return rels;\n  }\n\n  eachAttribute<K extends KeyOrString<T>>(\n    callback: (key: K, attribute: LegacyAttributeField) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        callback.call(binding, key as K, schema);\n      }\n    });\n  }\n\n  eachRelationship<K extends KeyOrString<T>>(\n    callback: (key: K, relationship: LegacyRelationshipField) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        callback.call(binding, key as K, schema);\n      }\n    });\n  }\n\n  eachTransformedAttribute<K extends KeyOrString<T>>(\n    callback: (key: K, type: string | null) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        const type = schema.type;\n        if (type) callback.call(binding, key as K, type);\n      }\n    });\n  }\n}\n","import type { Store } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { LegacyLiveArray, LegacyQueryArray, PrivateStore } from '@warp-drive/core/store/-private';\nimport {\n  assertPrivateStore,\n  constructResource,\n  ensureStringId,\n  recordIdentifierFor,\n  storeFor,\n} from '@warp-drive/core/store/-private';\nimport type { ResourceKey } from '@warp-drive/core/types/identifier';\nimport type { OpaqueRecordInstance, TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { ResourceIdentifierObject } from '@warp-drive/core/types/spec/json-api-raw';\n\nimport { isMaybeIdentifier } from './compat/builders/utils.ts';\nimport { normalizeModelName } from './model/-private/util.ts';\nimport type {\n  FindAllOptions,\n  FindRecordOptions,\n  LegacyResourceQuery,\n  ModelSchema,\n  QueryOptions,\n} from './store/-private.ts';\nimport { getShimClass, preloadData, RecordReference, resourceIsFullyDeleted } from './store/-private.ts';\n\n/**\n * Restores the deprecated `findRecord`/`findAll`/`query`/`queryRecord`/\n * `findBelongsTo`/`findHasMany`/`createRecord`/`deleteRecord`/`saveRecord`\n * legacy-network-layer implementations of these methods onto the given\n * `Store` subclass, for apps that have not yet migrated to the\n * `RequestManager`-based equivalents.\n */\nexport function restoreDeprecatedStoreBehaviors(StoreKlass: typeof Store): void {\n  StoreKlass.prototype.findRecord = function (\n    resource: string | ResourceIdentifierObject,\n    id?: string | number | FindRecordOptions,\n    options?: FindRecordOptions\n  ): Promise<unknown> {\n    assert(\n      `Attempted to call store.findRecord(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n\n    assert(\n      `You need to pass a modelName or resource identifier as the first argument to the store's findRecord method`,\n      resource\n    );\n    if (isMaybeIdentifier(resource)) {\n      options = id as FindRecordOptions;\n    } else {\n      assert(\n        `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${resource}`,\n        typeof resource === 'string'\n      );\n      const type = normalizeModelName(resource);\n      const normalizedId = ensureStringId(id as string | number);\n      resource = constructResource(type, normalizedId);\n    }\n\n    const identifier = this.cacheKeyManager.getOrCreateRecordIdentifier(resource);\n    options = options || {};\n    assertPrivateStore(this);\n\n    if (options.preload) {\n      // force reload if we preload to ensure we don't resolve the promise\n      // until we are complete, else we will end up background-reloading\n      // even for initial load.\n      if (!this._instanceCache.recordIsLoaded(identifier)) {\n        options.reload = true;\n      }\n      this._join(() => {\n        preloadData(this, identifier, options.preload!);\n      });\n    }\n\n    const promise = this.request<OpaqueRecordInstance>({\n      op: 'findRecord',\n      data: {\n        record: identifier,\n        options,\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => {\n      return document.content;\n    });\n  };\n\n  StoreKlass.prototype.findAll = function <T>(\n    type: TypeFromInstance<T> | string,\n    options: FindAllOptions = {}\n  ): Promise<LegacyLiveArray<T>> {\n    assert(\n      `Attempted to call store.findAll(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`You need to pass a model name to the store's findAll method`, type);\n    assert(\n      `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${type}`,\n      typeof type === 'string'\n    );\n\n    const promise = this.request<LegacyLiveArray<T>>({\n      op: 'findAll',\n      data: {\n        type: normalizeModelName(type),\n        options: options || {},\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => document.content);\n  };\n\n  StoreKlass.prototype.query = function (\n    type: string,\n    query: LegacyResourceQuery,\n    options: QueryOptions = {}\n  ): Promise<LegacyQueryArray> {\n    assert(\n      `Attempted to call store.query(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`You need to pass a model name to the store's query method`, type);\n    assert(`You need to pass a query hash to the store's query method`, query);\n    assert(\n      `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${type}`,\n      typeof type === 'string'\n    );\n\n    const promise = this.request<LegacyQueryArray>({\n      op: 'query',\n      data: {\n        type: normalizeModelName(type),\n        query,\n        options: options,\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => document.content);\n  };\n\n  StoreKlass.prototype.queryRecord = function (\n    type: string,\n    query: Record<string, unknown>,\n    options?: QueryOptions\n  ): Promise<OpaqueRecordInstance | null> {\n    assert(\n      `Attempted to call store.queryRecord(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`You need to pass a model name to the store's queryRecord method`, type);\n    assert(`You need to pass a query hash to the store's queryRecord method`, query);\n    assert(\n      `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${type}`,\n      typeof type === 'string'\n    );\n\n    const promise = this.request<OpaqueRecordInstance | null>({\n      op: 'queryRecord',\n      data: {\n        type: normalizeModelName(type),\n        query,\n        options: options || {},\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => document.content);\n  };\n\n  // do not put a ts-expect-error here, because typedoc will fail to\n  // build due to this error only occurring when references are in use in the editor.\n  // The return statement below casts to `PrivateStore['getReference']`'s return\n  // type rather than annotating this function `: RecordReference` directly,\n  // since this package's `RecordReference` and core's `deprecated/-private.ts`\n  // copy are structurally identical but nominally distinct classes (TS treats\n  // their private fields as separate brands); casting only the return value\n  // (instead of the whole function) keeps `this` contextually typed from the\n  // assignment target below.\n  StoreKlass.prototype.getReference = function (resource: string | ResourceIdentifierObject, id: string | number) {\n    assert(\n      `Attempted to call store.getReference(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n\n    let resourceIdentifier: ResourceIdentifierObject;\n    if (arguments.length === 1 && isMaybeIdentifier(resource)) {\n      resourceIdentifier = resource;\n    } else {\n      const type = normalizeModelName(resource as string);\n      const normalizedId = ensureStringId(id);\n      resourceIdentifier = constructResource(type, normalizedId);\n    }\n\n    assert(\n      'getReference expected to receive either a resource identifier or type and id as arguments',\n      isMaybeIdentifier(resourceIdentifier)\n    );\n\n    const identifier: ResourceKey = this.cacheKeyManager.getOrCreateRecordIdentifier(resourceIdentifier);\n    assertPrivateStore(this);\n\n    const cache = upgradeInstanceCaches(this._instanceCache.__instances).reference;\n    let reference = cache.get(identifier);\n\n    if (!reference) {\n      reference = new RecordReference(this, identifier);\n      cache.set(identifier, reference);\n    }\n    return reference;\n  };\n\n  StoreKlass.prototype.modelFor = function <T>(\n    type: T extends TypedRecordInstance ? TypeFromInstance<T> : string\n  ): ModelSchema<T> {\n    assert(`Attempted to call store.modelFor(), but the store instance has already been destroyed.`, !this.isDestroyed);\n    assert(`You need to pass <type> to the store's modelFor method`, typeof type === 'string' && type.length);\n    assert(`No model was found for '${type}' and no schema handles the type`, this.schema.hasResource({ type }));\n\n    return getShimClass<T>(this, type);\n  };\n\n  StoreKlass.prototype.saveRecord = function <T>(record: T, options: Record<string, unknown> = {}): Promise<T> {\n    assert(\n      `Attempted to call store.saveRecord(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`Unable to initiate save for a record in a disconnected state`, storeFor(record, true));\n    const identifier = recordIdentifierFor(record);\n    const cache = this.cache;\n\n    if (!identifier) {\n      // this commonly means we're disconnected\n      // but just in case we reject here to prevent bad things.\n      return Promise.reject(new Error(`Record Is Disconnected`));\n    }\n    assertPrivateStore(this);\n    assert(\n      `Cannot initiate a save request for an unloaded record: ${identifier.lid}`,\n      this._instanceCache.recordIsLoaded(identifier)\n    );\n    if (resourceIsFullyDeleted(this._instanceCache, identifier)) {\n      return Promise.resolve(record);\n    }\n\n    if (!options) {\n      options = {};\n    }\n    let operation: 'createRecord' | 'deleteRecord' | 'updateRecord' = 'updateRecord';\n\n    if (cache.isNew(identifier)) {\n      operation = 'createRecord';\n    } else if (cache.isDeleted(identifier)) {\n      operation = 'deleteRecord';\n    }\n\n    const request = {\n      op: operation,\n      data: {\n        options,\n        record: identifier,\n      },\n      records: [identifier],\n      cacheOptions: { [SkipCache]: true },\n    };\n\n    return this.request<T>(request).then((document) => document.content);\n  };\n}\n\nexport type { Store };\n\ntype Caches = PrivateStore['_instanceCache']['__instances'];\nfunction upgradeInstanceCaches(cache: Caches): Caches & { reference: WeakMap<ResourceKey, RecordReference> } {\n  const withReferences = cache as Caches & { reference: WeakMap<ResourceKey, RecordReference> };\n  if (!withReferences.reference) {\n    withReferences.reference = new WeakMap();\n  }\n\n  return withReferences;\n}\n"],"mappings":";;;;;;;;AAwCA,SAAgBK,YAAYC,OAAcC,YAA4BC,SAAsC;CAC1G,MAAMC,cAA+C,CAAC;CAGtD,MAAMG,SADUN,MAAMK,OACCC,OAAOL,UAAU;CACxCM,OAAOC,KAAKN,OAAO,CAAC,CAACO,SAASC,QAAQ;EACpC,MAAMC,eAAeT,QAAQQ;EAE7B,MAAME,QAAQN,OAAOO,IAAIH,GAAG;EAC5B,IAAIE,UAAUA,MAAME,SAAS,aAAaF,MAAME,SAAS,cAAc;GACrE,IAAI,CAACX,YAAYY,eACfZ,YAAYY,gBAAgB,CAAC;GAE/BZ,YAAYY,cAAcL,OAAOM,oBAAoBJ,OAAOD,YAAY;EAC1E,OAAO;GACL,IAAI,CAACR,YAAYc,YACfd,YAAYc,aAAa,CAAC;GAE5Bd,YAAYc,WAAWP,OAAOC;EAChC;CACF,CAAC;CACD,MAAMO,QAAQlB,MAAMkB;CACpBvB,mBAAmBK,KAAK;CACxB,MAAMmB,YAAYC,QAAQpB,MAAMqB,eAAeC,KAAKrB,UAAU,CAAC;CAC/DiB,MAAMK,OAAOtB,YAAYE,aAAagB,SAAS;AACjD;AAEA,SAASH,oBACPX,QACAM,cAC6D;CAC7D,MAAMa,cAAcnB,OAAOoB;CAE3B,IAAIpB,OAAOS,SAAS,WAElB,OAAO,EAAEY,MAAMf,aAAagB,KAAKC,UAAUC,kCAAkCD,OAAOJ,WAAW,CAAC,EAAE;CAIpG,OAAO,EAAEE,MAAMf,eAAekB,kCAAkClB,cAAca,WAAW,IAAI,KAAK;AACpG;AAMA,SAASK,kCACPD,OACAH,MACkC;CAClC,IAAI,OAAOG,UAAU,YAAY,OAAOA,UAAU,UAChD,OAAO;EAAEH;EAAMK,IAAIlC,eAAegC,KAAK;CAAE;CAI3C,OAAO/B,oBAAoB+B,KAAK;AAClC;;;;;;;;;;AAmEA,SAASG,uBAAuB9B,YAAyBiB,OAAuB;CAC9E,OAAOA,MAAMc,oBAAoB/B,UAAU,KAAMiB,MAAMe,MAAMhC,UAAU,KAAKiB,MAAMgB,UAAUjC,UAAU;AACxG;AAEA,SAAgBkC,uBAAuBC,eAA8BnC,YAAkC;CACrG,MAAMiB,QAAQkB,cAAclB;CAC5B,OAAO,CAACA,SAASa,uBAAuB9B,YAAYiB,KAAK;AAC3D;;;;;;;;AASA,IAAamB,kBAAb,MAA6B;;;CAKnBC;;CAEAC;;CAIRC,YAAYxC,OAAcC,YAAyB;EACjD,KAAKD,QAAQA;EACb,KAAKuC,gBAAgBtC;EACrB,KAAKqC,WAAWtC,MAAMyC,cAAcC,UAClCzC,aACC0C,GAAgBC,QAA0BC,gBAAyB;GAClE,IAAID,WAAW,cAAeA,WAAW,gBAAgBC,gBAAgB,MACvE,KAAKC;EAET,CACF;CACF;;CAGAC,UAAgB;EACd,KAAK/C,MAAMyC,cAAcO,YAAY,KAAKV,QAAQ;CACpD;CAEA,IAAIb,OAAe;EACjB,OAAO,KAAKxB,WAAW,CAAC,CAACwB;CAC3B;;;;;;;;;;;;;CAmBAK,KAAoB;EAElB,KAAKgB;EACL,OAAO,KAAKP,cAAcT;CAC5B;;;;;;;;;;;;;CAmBA7B,aAA0B;EACxB,OAAO,KAAKsC;CACd;;;;;;;;;;;;CAiBAU,aAAyB;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCAC,KAAKC,iBAA0G;EAE7G,OAAOC,QAAQC,QAAQF,eAAe,CAAC,CAACG,MAAM5B,SAAS;GACrD,OAAO,KAAK1B,MAAMkD,KAAKxB,IAAI;EAC7B,CAAC;CACH;;;;;;;;;;;;;CAkBAE,QAAqC;EACnC,OAAO,KAAK5B,MAAMuD,WAAW,KAAKhB,aAAa;CACjD;;;;;;;;;;;;;CAkBAiB,OAAyB;EACvB,MAAM1B,KAAK,KAAKA,GAAG;EACnB,IAAIA,OAAO,MACT,OAAO,KAAK9B,MAAMyD,WAAW,KAAKhC,MAAMK,EAAE;CAG9C;;;;;;;;;;;;;CAkBA4B,SAA2B;EACzB,MAAM5B,KAAK,KAAKA,GAAG;EACnB,IAAIA,OAAO,MACT,OAAO,KAAK9B,MAAMyD,WAAW,KAAKhC,MAAMK,IAAI,EAAE4B,QAAQ,KAAK,CAAC;CAGhE;AACF;AAEAhE,aAAa2C,gBAAgBsB,WAAW,MAAM;AAI9C,MAAMC,iBAAiB9D,eAAe,kCAAkB,IAAI+D,QAA+C,CAAC;AAE5G,SAAgBC,aACd9D,OACA+D,WACmB;CACnB,IAAIC,QAAQJ,eAAe/C,IAAIb,KAAK;CAEpC,IAAI,CAACgE,OAAO;EACVA,QAAQzD,OAAO0D,OAAO,IAAI;EAC1BL,eAAeM,IAAIlE,OAAOgE,KAAK;CACjC;CAEA,IAAIG,OAAOH,MAAMD;CACjB,IAAII,SAASC,QACXD,OAAOH,MAAMD,aAAa,IAAIM,eAAwBrE,OAAO+D,SAAS;CAGxE,OAAOI;AACT;AAGA,IAAaE,iBAAb,MAAmE;CAGjE7B,YAAYxC,OAAc+D,WAAyE;EACjG,KAAKO,UAAUtE;EACf,KAAK+D,YAAYA;CACnB;CAEA,IAAIzD,SAAqE;EACvE,MAAMA,yBAAS,IAAIiE,IAA2D;EAG9EC,AAFqB,KAAKF,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAEvES,CAAY,CAAC/D,SAASJ,QAAQK,QAAQ;GACpC,IAAIL,OAAOS,SAAS,eAAeT,OAAOS,SAAS,eAAeT,OAAOS,SAAS,WAChFR,OAAO4D,IAAIxD,KAAuBL,OAAOS,IAAI;EAEjD,CAAC;EAED,OAAOR;CACT;CAEA,IAAIW,aAAwD;EAC1D,MAAMwD,wBAAQ,IAAIF,IAA0C;EAG5DjE,AAFe,KAAKgE,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAEjEzD,CAAM,CAACG,SAASJ,QAAQK,QAAQ;GAC9B,IAAIL,OAAOS,SAAS,aAClB2D,MAAMP,IAAIxD,KAAuBL,MAAM;EAE3C,CAAC;EAED,OAAOoE;CACT;CAEA,IAAIC,sBAAoE;EACtE,MAAMC,uBAAO,IAAIJ,IAA6C;EAG9DjE,AAFe,KAAKgE,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAEjEzD,CAAM,CAACG,SAASJ,QAAQK,QAAQ;GAC9B,IAAIL,OAAOS,SAAS,eAAeT,OAAOS,SAAS,WACjD6D,KAAKT,IAAIxD,KAAuBL,MAAM;EAE1C,CAAC;EAED,OAAOsE;CACT;CAEAC,cACEC,UACAC,SACM;EACN,KAAKR,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAAC,CAAC,CAACtD,SAASJ,QAAQK,QAAQ;GAC5E,IAAIL,OAAOS,SAAS,aAClB+D,SAASE,KAAKD,SAASpE,KAAUL,MAAM;EAE3C,CAAC;CACH;CAEA2E,iBACEH,UACAC,SACM;EACN,KAAKR,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAAC,CAAC,CAACtD,SAASJ,QAAQK,QAAQ;GAC5E,IAAIL,OAAOS,SAAS,eAAeT,OAAOS,SAAS,WACjD+D,SAASE,KAAKD,SAASpE,KAAUL,MAAM;EAE3C,CAAC;CACH;CAEA4E,yBACEJ,UACAC,SACM;EACN,KAAKR,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAAC,CAAC,CAACtD,SAASJ,QAAQK,QAAQ;GAC5E,IAAIL,OAAOS,SAAS,aAAa;IAC/B,MAAMW,OAAOpB,OAAOoB;IACpB,IAAIA,MAAMoD,SAASE,KAAKD,SAASpE,KAAUe,IAAI;GACjD;EACF,CAAC;CACH;AACF;;;;;;;;;;;AC9cA,SAAgBqE,gCAAgCC,YAAgC;CAC9EA,WAAWC,UAAUC,aAAa,SAChCC,UACAC,IACAC,SACkB;EAUlB,IAAIZ,kBAAkBU,QAAQ,GAC5BE,UAAUD;OACL;GAKL,MAAME,OAAOZ,mBAAmBS,QAAQ;GACxC,MAAMI,eAAelB,eAAee,EAAqB;GACzDD,WAAWf,kBAAkBkB,MAAMC,YAAY;EACjD;EAEA,MAAMC,aAAa,KAAKC,gBAAgBC,4BAA4BP,QAAQ;EAC5EE,UAAUA,WAAW,CAAC;EACtBlB,mBAAmB,IAAI;EAEvB,IAAIkB,QAAQM,SAAS;GAInB,IAAI,CAAC,KAAKC,eAAeC,eAAeL,UAAU,GAChDH,QAAQS,SAAS;GAEnB,KAAKC,YAAY;IACfnB,YAAY,MAAMY,YAAYH,QAAQM,OAAQ;GAChD,CAAC;EACH;EAWA,OATgB,KAAKM,QAA8B;GACjDC,IAAI;GACJC,MAAM;IACJC,QAAQZ;IACRH;GACF;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAa;GAChC,OAAOA,SAASC;EAClB,CAAC;CACH;CAEAxB,WAAWC,UAAUwB,UAAU,SAC7BnB,MACAD,UAA0B,CAAC,GACE;EAoB7B,OATgB,KAAKY,QAA4B;GAC/CC,IAAI;GACJC,MAAM;IACJb,MAAMZ,mBAAmBY,IAAI;IAC7BD,SAASA,WAAW,CAAC;GACvB;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAaA,SAASC,OAAO;CACpD;CAEAxB,WAAWC,UAAUyB,QAAQ,SAC3BpB,MACAoB,OACArB,UAAwB,CAAC,GACE;EAsB3B,OAVgB,KAAKY,QAA0B;GAC7CC,IAAI;GACJC,MAAM;IACJb,MAAMZ,mBAAmBY,IAAI;IAC7BoB;IACSrB;GACX;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAaA,SAASC,OAAO;CACpD;CAEAxB,WAAWC,UAAU0B,cAAc,SACjCrB,MACAoB,OACArB,SACsC;EAsBtC,OAVgB,KAAKY,QAAqC;GACxDC,IAAI;GACJC,MAAM;IACJb,MAAMZ,mBAAmBY,IAAI;IAC7BoB;IACArB,SAASA,WAAW,CAAC;GACvB;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAaA,SAASC,OAAO;CACpD;CAWAxB,WAAWC,UAAU2B,eAAe,SAAUzB,UAA6CC,IAAqB;EAM9G,IAAIyB;EACJ,IAAIC,UAAUC,WAAW,KAAKtC,kBAAkBU,QAAQ,GACtD0B,qBAAqB1B;OAChB;GACL,MAAMG,OAAOZ,mBAAmBS,QAAkB;GAClD,MAAMI,eAAelB,eAAee,EAAE;GACtCyB,qBAAqBzC,kBAAkBkB,MAAMC,YAAY;EAC3D;EAOA,MAAMC,aAA0B,KAAKC,gBAAgBC,4BAA4BmB,kBAAkB;EACnG1C,mBAAmB,IAAI;EAEvB,MAAM6C,QAAQC,sBAAsB,KAAKrB,eAAesB,WAAW,CAAC,CAACC;EACrE,IAAIA,YAAYH,MAAMI,IAAI5B,UAAU;EAEpC,IAAI,CAAC2B,WAAW;GACdA,YAAY,IAAItC,gBAAgB,MAAMW,UAAU;GAChDwB,MAAMK,IAAI7B,YAAY2B,SAAS;EACjC;EACA,OAAOA;CACT;CAEAnC,WAAWC,UAAUqC,WAAW,SAC9BhC,MACgB;EAKhB,OAAOX,aAAgB,MAAMW,IAAI;CACnC;CAEAN,WAAWC,UAAUsC,aAAa,SAAanB,QAAWf,UAAmC,CAAC,GAAe;EAM3G,MAAMG,aAAalB,oBAAoB8B,MAAM;EAC7C,MAAMY,QAAQ,KAAKA;EAEnB,IAAI,CAACxB,YAGH,OAAOgC,QAAQC,uBAAO,IAAIC,MAAM,wBAAwB,CAAC;EAE3DvD,mBAAmB,IAAI;EAKvB,IAAIW,uBAAuB,KAAKc,gBAAgBJ,UAAU,GACxD,OAAOgC,QAAQG,QAAQvB,MAAM;EAG/B,IAAI,CAACf,SACHA,UAAU,CAAC;EAEb,IAAIuC,YAA8D;EAElE,IAAIZ,MAAMa,MAAMrC,UAAU,GACxBoC,YAAY;OACP,IAAIZ,MAAMc,UAAUtC,UAAU,GACnCoC,YAAY;EAGd,MAAM3B,UAAU;GACdC,IAAI0B;GACJzB,MAAM;IACJd;IACAe,QAAQZ;GACV;GACAuC,SAAS,CAACvC,UAAU;GACpBa,cAAc,GAAG7B,YAAY,KAAK;EACpC;EAEA,OAAO,KAAKyB,QAAWA,OAAO,CAAC,CAACK,MAAMC,aAAaA,SAASC,OAAO;CACrE;AACF;AAKA,SAASS,sBAAsBD,OAA8E;CAC3G,MAAMgB,iBAAiBhB;CACvB,IAAI,CAACgB,eAAeb,WAClBa,eAAeb,4BAAY,IAAIc,QAAQ;CAGzC,OAAOD;AACT"}
+{"version":3,"file":"store-BsSkzWgk.js","names":["defineSignal","assertPrivateStore","ensureStringId","recordIdentifierFor","getOrSetGlobal","preloadData","store","identifier","preload","jsonPayload","schemas","schema","fields","Object","keys","forEach","key","preloadValue","field","get","kind","relationships","preloadRelationship","attributes","cache","hasRecord","Boolean","_instanceCache","peek","upsert","relatedType","type","data","map","value","_convertPreloadRelationshipToJSON","id","_resourceIsFullDeleted","isDeletionCommitted","isNew","isDeleted","resourceIsFullyDeleted","instanceCache","RecordReference","___token","___identifier","constructor","notifications","subscribe","_","bucket","notifiedKey","_ref","destroy","unsubscribe","remoteType","push","objectOrPromise","Promise","resolve","then","peekRecord","load","findRecord","reload","prototype","AvailableShims","WeakMap","getShimClass","modelName","shims","create","set","shim","undefined","ShimModelClass","__store","Map","fieldSchemas","attrs","relationshipsByName","rels","eachAttribute","callback","binding","call","eachRelationship","eachTransformedAttribute","assertPrivateStore","constructResource","ensureStringId","recordIdentifierFor","storeFor","SkipCache","isMaybeIdentifier","normalizeModelName","getShimClass","preloadData","RecordReference","resourceIsFullyDeleted","restoreDeprecatedStoreBehaviors","StoreKlass","prototype","findRecord","resource","id","options","type","normalizedId","identifier","cacheKeyManager","getOrCreateRecordIdentifier","preload","_instanceCache","recordIsLoaded","reload","_join","promise","request","op","data","record","cacheOptions","then","document","content","findAll","query","queryRecord","getReference","resourceIdentifier","arguments","length","cache","upgradeInstanceCaches","__instances","reference","get","set","modelFor","saveRecord","Promise","reject","Error","resolve","operation","isNew","isDeleted","records","withReferences","WeakMap"],"sources":["../../../src/store/-private.ts","../../../src/store.ts"],"sourcesContent":["import type { NotificationType } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { defineSignal } from '@warp-drive/core/signals/-leaked';\nimport {\n  assertPrivateStore,\n  ensureStringId,\n  type InstanceCache,\n  recordIdentifierFor,\n} from '@warp-drive/core/store/-private';\nimport { getOrSetGlobal } from '@warp-drive/core/types/-private';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { NewResourceKey, ResourceKey } from '@warp-drive/core/types/identifier';\nimport type { Value } from '@warp-drive/core/types/json/raw';\nimport type { OpaqueRecordInstance, TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport type {\n  LegacyAttributeField,\n  LegacyRelationshipField,\n  LegacyRelationshipField as RelationshipSchema,\n} from '@warp-drive/core/types/schema/fields';\nimport type {\n  ExistingResourceIdentifierObject,\n  ExistingResourceObject,\n  InnerRelationshipDocument,\n  SingleResourceDocument,\n} from '@warp-drive/core/types/spec/json-api-raw';\n\nimport type { Store } from '../store.ts';\n\n/*\n    When a find request is triggered on the store, the user can optionally pass in\n    attributes and relationships to be preloaded. These are meant to behave as if they\n    came back from the server, except the user obtained them out of band and is informing\n    the store of their existence. The most common use case is for supporting client side\n    nested URLs, such as `/posts/1/comments/2` so the user can do\n    `store.findRecord('comment', 2, { preload: { post: 1 } })` without having to fetch the post.\n\n    Preloaded data can be attributes and relationships passed in either as IDs or as actual\n    models.\n  */\ntype PreloadRelationshipValue = OpaqueRecordInstance | string;\nexport function preloadData(store: Store, identifier: NewResourceKey, preload: Record<string, Value>): void {\n  const jsonPayload: Partial<ExistingResourceObject> = {};\n  //TODO(Igor) consider the polymorphic case\n  const schemas = store.schema;\n  const fields = schemas.fields(identifier);\n  Object.keys(preload).forEach((key) => {\n    const preloadValue = preload[key];\n\n    const field = fields.get(key);\n    if (field && (field.kind === 'hasMany' || field.kind === 'belongsTo')) {\n      if (!jsonPayload.relationships) {\n        jsonPayload.relationships = {};\n      }\n      jsonPayload.relationships[key] = preloadRelationship(field, preloadValue);\n    } else {\n      if (!jsonPayload.attributes) {\n        jsonPayload.attributes = {};\n      }\n      jsonPayload.attributes[key] = preloadValue;\n    }\n  });\n  const cache = store.cache;\n  assertPrivateStore(store);\n  const hasRecord = Boolean(store._instanceCache.peek(identifier));\n  cache.upsert(identifier, jsonPayload, hasRecord);\n}\n\nfunction preloadRelationship(\n  schema: RelationshipSchema,\n  preloadValue: PreloadRelationshipValue | null | Array<PreloadRelationshipValue>\n): InnerRelationshipDocument<ExistingResourceIdentifierObject> {\n  const relatedType = schema.type;\n\n  if (schema.kind === 'hasMany') {\n    assert('You need to pass in an array to set a hasMany property on a record', Array.isArray(preloadValue));\n    return { data: preloadValue.map((value) => _convertPreloadRelationshipToJSON(value, relatedType)) };\n  }\n\n  assert('You should not pass in an array to set a belongsTo property on a record', !Array.isArray(preloadValue));\n  return { data: preloadValue ? _convertPreloadRelationshipToJSON(preloadValue, relatedType) : null };\n}\n\n/*\n  findRecord('user', '1', { preload: { friends: ['1'] }});\n  findRecord('user', '1', { preload: { friends: [record] }});\n*/\nfunction _convertPreloadRelationshipToJSON(\n  value: OpaqueRecordInstance | string,\n  type: string\n): ExistingResourceIdentifierObject {\n  if (typeof value === 'string' || typeof value === 'number') {\n    return { type, id: ensureStringId(value) };\n  }\n  // TODO if not a record instance assert it's an identifier\n  // and allow identifiers to be used\n  return recordIdentifierFor(value) as ExistingResourceIdentifierObject;\n}\n\nexport interface BaseFinderOptions {\n  reload?: boolean;\n  backgroundReload?: boolean;\n  include?: string | string[];\n  adapterOptions?: Record<string, unknown>;\n}\nexport interface FindRecordOptions extends BaseFinderOptions {\n  /**\n   * Data to preload into the store before the request is made.\n   * This feature is *highly* discouraged and has no corresponding\n   * feature when using builders and handlers.\n   *\n   * Excepting relationships: the data should be in the form of a\n   * JSON object where the keys are fields on the record and the value\n   * is the raw value to be added to the cache.\n   *\n   * Relationships can either be provided as string IDs from which\n   * an identifier will be built base upon the relationship's expected\n   * resource type, or be record instances from which the identifier\n   * will be extracted.\n   *\n   */\n  preload?: Record<string, Value>;\n}\n\nexport type QueryOptions = {\n  [K in string | 'adapterOptions']?: K extends 'adapterOptions' ? Record<string, unknown> : unknown;\n};\n\nexport type FindAllOptions = BaseFinderOptions;\nexport type LegacyResourceQuery = {\n  include?: string | string[];\n  [key: string]: Value | undefined;\n};\n\nexport type KeyOrString<T> = keyof T & string extends never ? string : keyof T & string;\n\n/**\n * Minimum subset of static schema methods and properties on the\n * \"model\" class.\n *\n * Only used when using the legacy schema-service implementation\n * for @ember-data/model or when wrapping schema for legacy\n * Adapters/Serializers.\n *\n */\nexport interface ModelSchema<T = unknown> {\n  modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;\n  fields: Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'>;\n  attributes: Map<KeyOrString<T>, LegacyAttributeField>;\n  relationshipsByName: Map<KeyOrString<T>, LegacyRelationshipField>;\n  eachAttribute<K extends KeyOrString<T>>(\n    callback: (this: ModelSchema<T>, key: K, attribute: LegacyAttributeField) => void,\n    binding?: T\n  ): void;\n  eachRelationship<K extends KeyOrString<T>>(\n    callback: (this: ModelSchema<T>, key: K, relationship: LegacyRelationshipField) => void,\n    binding?: T\n  ): void;\n  eachTransformedAttribute<K extends KeyOrString<T>>(\n    callback: (this: ModelSchema<T>, key: K, type: string | null) => void,\n    binding?: T\n  ): void;\n}\n\nfunction _resourceIsFullDeleted(identifier: ResourceKey, cache: Cache): boolean {\n  return cache.isDeletionCommitted(identifier) || (cache.isNew(identifier) && cache.isDeleted(identifier));\n}\n\nexport function resourceIsFullyDeleted(instanceCache: InstanceCache, identifier: ResourceKey): boolean {\n  const cache = instanceCache.cache;\n  return !cache || _resourceIsFullDeleted(identifier, cache);\n}\n\n/**\n   A `RecordReference` is a low-level API that allows users and\n   addon authors to perform meta-operations on a record.\n\n   @hideconstructor\n   @public\n*/\nexport class RecordReference {\n  /** @internal */\n  declare private store: Store;\n  // unsubscribe token given to us by the notification manager\n  /** @internal */\n  private ___token!: object;\n  /** @internal */\n  private ___identifier: ResourceKey;\n  /** @internal */\n  declare private _ref: number;\n\n  constructor(store: Store, identifier: ResourceKey) {\n    this.store = store;\n    this.___identifier = identifier;\n    this.___token = store.notifications.subscribe(\n      identifier,\n      (_: ResourceKey, bucket: NotificationType, notifiedKey?: string) => {\n        if (bucket === 'identity' || (bucket === 'attributes' && notifiedKey === 'id')) {\n          this._ref++;\n        }\n      }\n    );\n  }\n\n  /** @internal */\n  destroy(): void {\n    this.store.notifications.unsubscribe(this.___token);\n  }\n\n  get type(): string {\n    return this.identifier().type;\n  }\n\n  /**\n     The `id` of the record that this reference refers to.\n\n     Together, the `type` and `id` properties form a composite key for\n     the identity map.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     userRef.id(); // '1'\n     ```\n\n    @public\n    @return The id of the record.\n  */\n  id(): string | null {\n    // oxlint-disable-next-line no-unused-expressions\n    this._ref; // consume the tracked prop\n    return this.___identifier.id;\n  }\n\n  /**\n     The `identifier` of the record that this reference refers to.\n\n     Together, the `type` and `id` properties form a composite key for\n     the identity map.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     userRef.identifier(); // '1'\n     ```\n\n    @public\n    @return The identifier of the record.\n  */\n  identifier(): ResourceKey {\n    return this.___identifier;\n  }\n\n  /**\n     How the reference will be looked up when it is loaded. Currently\n     this always returns `identity` to signify that a record will be\n     loaded by its `type` and `id`.\n\n     Example\n\n     ```javascript\n     const userRef = store.getReference('user', 1);\n\n     userRef.remoteType(); // 'identity'\n     ```\n\n     @public\n  */\n  remoteType(): 'identity' {\n    return 'identity';\n  }\n\n  /**\n    This API allows you to provide a reference with new data. The\n    simplest usage of this API is similar to `store.push`: you provide a\n    normalized hash of data and the object represented by the reference\n    will update.\n\n    If you pass a promise to `push`, WarpDrive will not ask the adapter\n    for the data if another attempt to fetch it is made in the\n    interim. When the promise resolves, the underlying object is updated\n    with the new data, and the promise returned by *this function* is resolved\n    with that object.\n\n    For example, `recordReference.push(promise)` will be resolved with a\n    record.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     // provide data for reference\n     userRef.push({\n       data: {\n         id: \"1\",\n         type: \"user\",\n         attributes: {\n           username: \"@user\"\n         }\n       }\n     }).then(function(user) {\n       userRef.value() === user;\n     });\n     ```\n\n    @public\n    @param objectOrPromise a JSON:API ResourceDocument or a promise resolving to one\n    @return a promise for the value (record or relationship)\n  */\n  push(objectOrPromise: SingleResourceDocument | Promise<SingleResourceDocument>): Promise<OpaqueRecordInstance> {\n    // TODO @deprecate pushing unresolved payloads\n    return Promise.resolve(objectOrPromise).then((data) => {\n      return this.store.push(data);\n    });\n  }\n\n  /**\n    If the entity referred to by the reference is already loaded, it is\n    present as `reference.value`. Otherwise the value returned by this function\n    is `null`.\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     userRef.value(); // user\n     ```\n\n    @public\n    @return the record for this RecordReference\n  */\n  value(): OpaqueRecordInstance | null {\n    return this.store.peekRecord(this.___identifier);\n  }\n\n  /**\n     Triggers a fetch for the backing entity based on its `remoteType`\n     (see `remoteType` definitions per reference type).\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     // load user (via store.find)\n     userRef.load().then(...)\n     ```\n\n    @public\n    @return the record for this RecordReference\n  */\n  load(): Promise<unknown> {\n    const id = this.id();\n    if (id !== null) {\n      return this.store.findRecord(this.type, id);\n    }\n    assert(`Unable to fetch record of type ${this.type} without an id`);\n  }\n\n  /**\n     Reloads the record if it is already loaded. If the record is not\n     loaded it will load the record via `store.findRecord`\n\n     Example\n\n     ```javascript\n     let userRef = store.getReference('user', 1);\n\n     // or trigger a reload\n     userRef.reload().then(...)\n     ```\n\n    @public\n    @return the record for this RecordReference\n  */\n  reload(): Promise<unknown> {\n    const id = this.id();\n    if (id !== null) {\n      return this.store.findRecord(this.type, id, { reload: true });\n    }\n    assert(`Unable to fetch record of type ${this.type} without an id`);\n  }\n}\n\ndefineSignal(RecordReference.prototype, '_ref');\n\n// if modelFor turns out to be a bottleneck we should replace with a Map\n// and clear it during store teardown.\nconst AvailableShims = getOrSetGlobal('AvailableShims', new WeakMap<Store, Record<string, ShimModelClass>>());\n\nexport function getShimClass<T>(\n  store: Store,\n  modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string\n): ShimModelClass<T> {\n  let shims = AvailableShims.get(store);\n\n  if (!shims) {\n    shims = Object.create(null) as Record<string, ShimModelClass>;\n    AvailableShims.set(store, shims);\n  }\n\n  let shim = shims[modelName];\n  if (shim === undefined) {\n    shim = shims[modelName] = new ShimModelClass<unknown>(store, modelName);\n  }\n\n  return shim;\n}\n\n// Mimics the static apis of @ember-data/model\nexport class ShimModelClass<T = unknown> implements ModelSchema<T> {\n  declare __store: Store;\n  declare modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string;\n  constructor(store: Store, modelName: T extends TypedRecordInstance ? TypeFromInstance<T> : string) {\n    this.__store = store;\n    this.modelName = modelName;\n  }\n\n  get fields(): Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'> {\n    const fields = new Map<KeyOrString<T>, 'attribute' | 'belongsTo' | 'hasMany'>();\n    const fieldSchemas = this.__store.schema.fields({ type: this.modelName });\n\n    fieldSchemas.forEach((schema, key) => {\n      if (schema.kind === 'attribute' || schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        fields.set(key as KeyOrString<T>, schema.kind);\n      }\n    });\n\n    return fields;\n  }\n\n  get attributes(): Map<KeyOrString<T>, LegacyAttributeField> {\n    const attrs = new Map<KeyOrString<T>, LegacyAttributeField>();\n    const fields = this.__store.schema.fields({ type: this.modelName });\n\n    fields.forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        attrs.set(key as KeyOrString<T>, schema);\n      }\n    });\n\n    return attrs;\n  }\n\n  get relationshipsByName(): Map<KeyOrString<T>, LegacyRelationshipField> {\n    const rels = new Map<KeyOrString<T>, LegacyRelationshipField>();\n    const fields = this.__store.schema.fields({ type: this.modelName });\n\n    fields.forEach((schema, key) => {\n      if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        rels.set(key as KeyOrString<T>, schema);\n      }\n    });\n\n    return rels;\n  }\n\n  eachAttribute<K extends KeyOrString<T>>(\n    callback: (key: K, attribute: LegacyAttributeField) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        callback.call(binding, key as K, schema);\n      }\n    });\n  }\n\n  eachRelationship<K extends KeyOrString<T>>(\n    callback: (key: K, relationship: LegacyRelationshipField) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'belongsTo' || schema.kind === 'hasMany') {\n        callback.call(binding, key as K, schema);\n      }\n    });\n  }\n\n  eachTransformedAttribute<K extends KeyOrString<T>>(\n    callback: (key: K, type: string | null) => void,\n    binding?: T\n  ): void {\n    this.__store.schema.fields({ type: this.modelName }).forEach((schema, key) => {\n      if (schema.kind === 'attribute') {\n        const type = schema.type;\n        if (type) callback.call(binding, key as K, type);\n      }\n    });\n  }\n}\n","/**\n * @module\n * @summary Legacy `restoreDeprecatedStoreBehaviors`, which restores the adapter-based `findRecord`, `findAll`, `query`,\n * `saveRecord` and related methods onto a `Store` class.\n */\n\nimport type { Store } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { LegacyLiveArray, LegacyQueryArray, PrivateStore } from '@warp-drive/core/store/-private';\nimport {\n  assertPrivateStore,\n  constructResource,\n  ensureStringId,\n  recordIdentifierFor,\n  storeFor,\n} from '@warp-drive/core/store/-private';\nimport type { ResourceKey } from '@warp-drive/core/types/identifier';\nimport type { OpaqueRecordInstance, TypedRecordInstance, TypeFromInstance } from '@warp-drive/core/types/record';\nimport { SkipCache } from '@warp-drive/core/types/request';\nimport type { ResourceIdentifierObject } from '@warp-drive/core/types/spec/json-api-raw';\n\nimport { isMaybeIdentifier } from './compat/builders/utils.ts';\nimport { normalizeModelName } from './model/-private/util.ts';\nimport type {\n  FindAllOptions,\n  FindRecordOptions,\n  LegacyResourceQuery,\n  ModelSchema,\n  QueryOptions,\n} from './store/-private.ts';\nimport { getShimClass, preloadData, RecordReference, resourceIsFullyDeleted } from './store/-private.ts';\n\n/**\n * Restores the deprecated `findRecord`/`findAll`/`query`/`queryRecord`/\n * `findBelongsTo`/`findHasMany`/`createRecord`/`deleteRecord`/`saveRecord`\n * legacy-network-layer implementations of these methods onto the given\n * `Store` subclass, for apps that have not yet migrated to the\n * `RequestManager`-based equivalents.\n *\n * @summary Legacy opt-in that restores the adapter-based `findRecord`, `findAll`, `query`, `saveRecord`, and related\n * methods onto a `Store` class.\n */\nexport function restoreDeprecatedStoreBehaviors(StoreKlass: typeof Store): void {\n  StoreKlass.prototype.findRecord = function (\n    resource: string | ResourceIdentifierObject,\n    id?: string | number | FindRecordOptions,\n    options?: FindRecordOptions\n  ): Promise<unknown> {\n    assert(\n      `Attempted to call store.findRecord(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n\n    assert(\n      `You need to pass a modelName or resource identifier as the first argument to the store's findRecord method`,\n      resource\n    );\n    if (isMaybeIdentifier(resource)) {\n      options = id as FindRecordOptions;\n    } else {\n      assert(\n        `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${resource}`,\n        typeof resource === 'string'\n      );\n      const type = normalizeModelName(resource);\n      const normalizedId = ensureStringId(id as string | number);\n      resource = constructResource(type, normalizedId);\n    }\n\n    const identifier = this.cacheKeyManager.getOrCreateRecordIdentifier(resource);\n    options = options || {};\n    assertPrivateStore(this);\n\n    if (options.preload) {\n      // force reload if we preload to ensure we don't resolve the promise\n      // until we are complete, else we will end up background-reloading\n      // even for initial load.\n      if (!this._instanceCache.recordIsLoaded(identifier)) {\n        options.reload = true;\n      }\n      this._join(() => {\n        preloadData(this, identifier, options.preload!);\n      });\n    }\n\n    const promise = this.request<OpaqueRecordInstance>({\n      op: 'findRecord',\n      data: {\n        record: identifier,\n        options,\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => {\n      return document.content;\n    });\n  };\n\n  StoreKlass.prototype.findAll = function <T>(\n    type: TypeFromInstance<T> | string,\n    options: FindAllOptions = {}\n  ): Promise<LegacyLiveArray<T>> {\n    assert(\n      `Attempted to call store.findAll(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`You need to pass a model name to the store's findAll method`, type);\n    assert(\n      `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${type}`,\n      typeof type === 'string'\n    );\n\n    const promise = this.request<LegacyLiveArray<T>>({\n      op: 'findAll',\n      data: {\n        type: normalizeModelName(type),\n        options: options || {},\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => document.content);\n  };\n\n  StoreKlass.prototype.query = function (\n    type: string,\n    query: LegacyResourceQuery,\n    options: QueryOptions = {}\n  ): Promise<LegacyQueryArray> {\n    assert(\n      `Attempted to call store.query(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`You need to pass a model name to the store's query method`, type);\n    assert(`You need to pass a query hash to the store's query method`, query);\n    assert(\n      `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${type}`,\n      typeof type === 'string'\n    );\n\n    const promise = this.request<LegacyQueryArray>({\n      op: 'query',\n      data: {\n        type: normalizeModelName(type),\n        query,\n        options: options,\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => document.content);\n  };\n\n  StoreKlass.prototype.queryRecord = function (\n    type: string,\n    query: Record<string, unknown>,\n    options?: QueryOptions\n  ): Promise<OpaqueRecordInstance | null> {\n    assert(\n      `Attempted to call store.queryRecord(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`You need to pass a model name to the store's queryRecord method`, type);\n    assert(`You need to pass a query hash to the store's queryRecord method`, query);\n    assert(\n      `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${type}`,\n      typeof type === 'string'\n    );\n\n    const promise = this.request<OpaqueRecordInstance | null>({\n      op: 'queryRecord',\n      data: {\n        type: normalizeModelName(type),\n        query,\n        options: options || {},\n      },\n      cacheOptions: { [SkipCache]: true },\n    });\n\n    return promise.then((document) => document.content);\n  };\n\n  // do not put a ts-expect-error here, because typedoc will fail to\n  // build due to this error only occurring when references are in use in the editor.\n  // The return statement below casts to `PrivateStore['getReference']`'s return\n  // type rather than annotating this function `: RecordReference` directly,\n  // since this package's `RecordReference` and core's `deprecated/-private.ts`\n  // copy are structurally identical but nominally distinct classes (TS treats\n  // their private fields as separate brands); casting only the return value\n  // (instead of the whole function) keeps `this` contextually typed from the\n  // assignment target below.\n  StoreKlass.prototype.getReference = function (resource: string | ResourceIdentifierObject, id: string | number) {\n    assert(\n      `Attempted to call store.getReference(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n\n    let resourceIdentifier: ResourceIdentifierObject;\n    if (arguments.length === 1 && isMaybeIdentifier(resource)) {\n      resourceIdentifier = resource;\n    } else {\n      const type = normalizeModelName(resource as string);\n      const normalizedId = ensureStringId(id);\n      resourceIdentifier = constructResource(type, normalizedId);\n    }\n\n    assert(\n      'getReference expected to receive either a resource identifier or type and id as arguments',\n      isMaybeIdentifier(resourceIdentifier)\n    );\n\n    const identifier: ResourceKey = this.cacheKeyManager.getOrCreateRecordIdentifier(resourceIdentifier);\n    assertPrivateStore(this);\n\n    const cache = upgradeInstanceCaches(this._instanceCache.__instances).reference;\n    let reference = cache.get(identifier);\n\n    if (!reference) {\n      reference = new RecordReference(this, identifier);\n      cache.set(identifier, reference);\n    }\n    return reference;\n  };\n\n  StoreKlass.prototype.modelFor = function <T>(\n    type: T extends TypedRecordInstance ? TypeFromInstance<T> : string\n  ): ModelSchema<T> {\n    assert(`Attempted to call store.modelFor(), but the store instance has already been destroyed.`, !this.isDestroyed);\n    assert(`You need to pass <type> to the store's modelFor method`, typeof type === 'string' && type.length);\n    assert(`No model was found for '${type}' and no schema handles the type`, this.schema.hasResource({ type }));\n\n    return getShimClass<T>(this, type);\n  };\n\n  StoreKlass.prototype.saveRecord = function <T>(record: T, options: Record<string, unknown> = {}): Promise<T> {\n    assert(\n      `Attempted to call store.saveRecord(), but the store instance has already been destroyed.`,\n      !(this.isDestroying || this.isDestroyed)\n    );\n    assert(`Unable to initiate save for a record in a disconnected state`, storeFor(record, true));\n    const identifier = recordIdentifierFor(record);\n    const cache = this.cache;\n\n    if (!identifier) {\n      // this commonly means we're disconnected\n      // but just in case we reject here to prevent bad things.\n      return Promise.reject(new Error(`Record Is Disconnected`));\n    }\n    assertPrivateStore(this);\n    assert(\n      `Cannot initiate a save request for an unloaded record: ${identifier.lid}`,\n      this._instanceCache.recordIsLoaded(identifier)\n    );\n    if (resourceIsFullyDeleted(this._instanceCache, identifier)) {\n      return Promise.resolve(record);\n    }\n\n    if (!options) {\n      options = {};\n    }\n    let operation: 'createRecord' | 'deleteRecord' | 'updateRecord' = 'updateRecord';\n\n    if (cache.isNew(identifier)) {\n      operation = 'createRecord';\n    } else if (cache.isDeleted(identifier)) {\n      operation = 'deleteRecord';\n    }\n\n    const request = {\n      op: operation,\n      data: {\n        options,\n        record: identifier,\n      },\n      records: [identifier],\n      cacheOptions: { [SkipCache]: true },\n    };\n\n    return this.request<T>(request).then((document) => document.content);\n  };\n}\n\nexport type { Store };\n\ntype Caches = PrivateStore['_instanceCache']['__instances'];\nfunction upgradeInstanceCaches(cache: Caches): Caches & { reference: WeakMap<ResourceKey, RecordReference> } {\n  const withReferences = cache as Caches & { reference: WeakMap<ResourceKey, RecordReference> };\n  if (!withReferences.reference) {\n    withReferences.reference = new WeakMap();\n  }\n\n  return withReferences;\n}\n"],"mappings":";;;;;;;;AAwCA,SAAgBK,YAAYC,OAAcC,YAA4BC,SAAsC;CAC1G,MAAMC,cAA+C,CAAC;CAGtD,MAAMG,SADUN,MAAMK,OACCC,OAAOL,UAAU;CACxCM,OAAOC,KAAKN,OAAO,CAAC,CAACO,SAASC,QAAQ;EACpC,MAAMC,eAAeT,QAAQQ;EAE7B,MAAME,QAAQN,OAAOO,IAAIH,GAAG;EAC5B,IAAIE,UAAUA,MAAME,SAAS,aAAaF,MAAME,SAAS,cAAc;GACrE,IAAI,CAACX,YAAYY,eACfZ,YAAYY,gBAAgB,CAAC;GAE/BZ,YAAYY,cAAcL,OAAOM,oBAAoBJ,OAAOD,YAAY;EAC1E,OAAO;GACL,IAAI,CAACR,YAAYc,YACfd,YAAYc,aAAa,CAAC;GAE5Bd,YAAYc,WAAWP,OAAOC;EAChC;CACF,CAAC;CACD,MAAMO,QAAQlB,MAAMkB;CACpBvB,mBAAmBK,KAAK;CACxB,MAAMmB,YAAYC,QAAQpB,MAAMqB,eAAeC,KAAKrB,UAAU,CAAC;CAC/DiB,MAAMK,OAAOtB,YAAYE,aAAagB,SAAS;AACjD;AAEA,SAASH,oBACPX,QACAM,cAC6D;CAC7D,MAAMa,cAAcnB,OAAOoB;CAE3B,IAAIpB,OAAOS,SAAS,WAElB,OAAO,EAAEY,MAAMf,aAAagB,KAAKC,UAAUC,kCAAkCD,OAAOJ,WAAW,CAAC,EAAE;CAIpG,OAAO,EAAEE,MAAMf,eAAekB,kCAAkClB,cAAca,WAAW,IAAI,KAAK;AACpG;AAMA,SAASK,kCACPD,OACAH,MACkC;CAClC,IAAI,OAAOG,UAAU,YAAY,OAAOA,UAAU,UAChD,OAAO;EAAEH;EAAMK,IAAIlC,eAAegC,KAAK;CAAE;CAI3C,OAAO/B,oBAAoB+B,KAAK;AAClC;;;;;;;;;;AAmEA,SAASG,uBAAuB9B,YAAyBiB,OAAuB;CAC9E,OAAOA,MAAMc,oBAAoB/B,UAAU,KAAMiB,MAAMe,MAAMhC,UAAU,KAAKiB,MAAMgB,UAAUjC,UAAU;AACxG;AAEA,SAAgBkC,uBAAuBC,eAA8BnC,YAAkC;CACrG,MAAMiB,QAAQkB,cAAclB;CAC5B,OAAO,CAACA,SAASa,uBAAuB9B,YAAYiB,KAAK;AAC3D;;;;;;;;AASA,IAAamB,kBAAb,MAA6B;;;CAKnBC;;CAEAC;;CAIRC,YAAYxC,OAAcC,YAAyB;EACjD,KAAKD,QAAQA;EACb,KAAKuC,gBAAgBtC;EACrB,KAAKqC,WAAWtC,MAAMyC,cAAcC,UAClCzC,aACC0C,GAAgBC,QAA0BC,gBAAyB;GAClE,IAAID,WAAW,cAAeA,WAAW,gBAAgBC,gBAAgB,MACvE,KAAKC;EAET,CACF;CACF;;CAGAC,UAAgB;EACd,KAAK/C,MAAMyC,cAAcO,YAAY,KAAKV,QAAQ;CACpD;CAEA,IAAIb,OAAe;EACjB,OAAO,KAAKxB,WAAW,CAAC,CAACwB;CAC3B;;;;;;;;;;;;;CAmBAK,KAAoB;EAElB,KAAKgB;EACL,OAAO,KAAKP,cAAcT;CAC5B;;;;;;;;;;;;;CAmBA7B,aAA0B;EACxB,OAAO,KAAKsC;CACd;;;;;;;;;;;;CAiBAU,aAAyB;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCAC,KAAKC,iBAA0G;EAE7G,OAAOC,QAAQC,QAAQF,eAAe,CAAC,CAACG,MAAM5B,SAAS;GACrD,OAAO,KAAK1B,MAAMkD,KAAKxB,IAAI;EAC7B,CAAC;CACH;;;;;;;;;;;;;CAkBAE,QAAqC;EACnC,OAAO,KAAK5B,MAAMuD,WAAW,KAAKhB,aAAa;CACjD;;;;;;;;;;;;;CAkBAiB,OAAyB;EACvB,MAAM1B,KAAK,KAAKA,GAAG;EACnB,IAAIA,OAAO,MACT,OAAO,KAAK9B,MAAMyD,WAAW,KAAKhC,MAAMK,EAAE;CAG9C;;;;;;;;;;;;;CAkBA4B,SAA2B;EACzB,MAAM5B,KAAK,KAAKA,GAAG;EACnB,IAAIA,OAAO,MACT,OAAO,KAAK9B,MAAMyD,WAAW,KAAKhC,MAAMK,IAAI,EAAE4B,QAAQ,KAAK,CAAC;CAGhE;AACF;AAEAhE,aAAa2C,gBAAgBsB,WAAW,MAAM;AAI9C,MAAMC,iBAAiB9D,eAAe,kCAAkB,IAAI+D,QAA+C,CAAC;AAE5G,SAAgBC,aACd9D,OACA+D,WACmB;CACnB,IAAIC,QAAQJ,eAAe/C,IAAIb,KAAK;CAEpC,IAAI,CAACgE,OAAO;EACVA,QAAQzD,OAAO0D,OAAO,IAAI;EAC1BL,eAAeM,IAAIlE,OAAOgE,KAAK;CACjC;CAEA,IAAIG,OAAOH,MAAMD;CACjB,IAAII,SAASC,QACXD,OAAOH,MAAMD,aAAa,IAAIM,eAAwBrE,OAAO+D,SAAS;CAGxE,OAAOI;AACT;AAGA,IAAaE,iBAAb,MAAmE;CAGjE7B,YAAYxC,OAAc+D,WAAyE;EACjG,KAAKO,UAAUtE;EACf,KAAK+D,YAAYA;CACnB;CAEA,IAAIzD,SAAqE;EACvE,MAAMA,yBAAS,IAAIiE,IAA2D;EAG9EC,AAFqB,KAAKF,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAEvES,CAAY,CAAC/D,SAASJ,QAAQK,QAAQ;GACpC,IAAIL,OAAOS,SAAS,eAAeT,OAAOS,SAAS,eAAeT,OAAOS,SAAS,WAChFR,OAAO4D,IAAIxD,KAAuBL,OAAOS,IAAI;EAEjD,CAAC;EAED,OAAOR;CACT;CAEA,IAAIW,aAAwD;EAC1D,MAAMwD,wBAAQ,IAAIF,IAA0C;EAG5DjE,AAFe,KAAKgE,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAEjEzD,CAAM,CAACG,SAASJ,QAAQK,QAAQ;GAC9B,IAAIL,OAAOS,SAAS,aAClB2D,MAAMP,IAAIxD,KAAuBL,MAAM;EAE3C,CAAC;EAED,OAAOoE;CACT;CAEA,IAAIC,sBAAoE;EACtE,MAAMC,uBAAO,IAAIJ,IAA6C;EAG9DjE,AAFe,KAAKgE,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAEjEzD,CAAM,CAACG,SAASJ,QAAQK,QAAQ;GAC9B,IAAIL,OAAOS,SAAS,eAAeT,OAAOS,SAAS,WACjD6D,KAAKT,IAAIxD,KAAuBL,MAAM;EAE1C,CAAC;EAED,OAAOsE;CACT;CAEAC,cACEC,UACAC,SACM;EACN,KAAKR,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAAC,CAAC,CAACtD,SAASJ,QAAQK,QAAQ;GAC5E,IAAIL,OAAOS,SAAS,aAClB+D,SAASE,KAAKD,SAASpE,KAAUL,MAAM;EAE3C,CAAC;CACH;CAEA2E,iBACEH,UACAC,SACM;EACN,KAAKR,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAAC,CAAC,CAACtD,SAASJ,QAAQK,QAAQ;GAC5E,IAAIL,OAAOS,SAAS,eAAeT,OAAOS,SAAS,WACjD+D,SAASE,KAAKD,SAASpE,KAAUL,MAAM;EAE3C,CAAC;CACH;CAEA4E,yBACEJ,UACAC,SACM;EACN,KAAKR,QAAQjE,OAAOC,OAAO,EAAEmB,MAAM,KAAKsC,UAAU,CAAC,CAAC,CAACtD,SAASJ,QAAQK,QAAQ;GAC5E,IAAIL,OAAOS,SAAS,aAAa;IAC/B,MAAMW,OAAOpB,OAAOoB;IACpB,IAAIA,MAAMoD,SAASE,KAAKD,SAASpE,KAAUe,IAAI;GACjD;EACF,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;;ACrcA,SAAgBqE,gCAAgCC,YAAgC;CAC9EA,WAAWC,UAAUC,aAAa,SAChCC,UACAC,IACAC,SACkB;EAUlB,IAAIZ,kBAAkBU,QAAQ,GAC5BE,UAAUD;OACL;GAKL,MAAME,OAAOZ,mBAAmBS,QAAQ;GACxC,MAAMI,eAAelB,eAAee,EAAqB;GACzDD,WAAWf,kBAAkBkB,MAAMC,YAAY;EACjD;EAEA,MAAMC,aAAa,KAAKC,gBAAgBC,4BAA4BP,QAAQ;EAC5EE,UAAUA,WAAW,CAAC;EACtBlB,mBAAmB,IAAI;EAEvB,IAAIkB,QAAQM,SAAS;GAInB,IAAI,CAAC,KAAKC,eAAeC,eAAeL,UAAU,GAChDH,QAAQS,SAAS;GAEnB,KAAKC,YAAY;IACfnB,YAAY,MAAMY,YAAYH,QAAQM,OAAQ;GAChD,CAAC;EACH;EAWA,OATgB,KAAKM,QAA8B;GACjDC,IAAI;GACJC,MAAM;IACJC,QAAQZ;IACRH;GACF;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAa;GAChC,OAAOA,SAASC;EAClB,CAAC;CACH;CAEAxB,WAAWC,UAAUwB,UAAU,SAC7BnB,MACAD,UAA0B,CAAC,GACE;EAoB7B,OATgB,KAAKY,QAA4B;GAC/CC,IAAI;GACJC,MAAM;IACJb,MAAMZ,mBAAmBY,IAAI;IAC7BD,SAASA,WAAW,CAAC;GACvB;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAaA,SAASC,OAAO;CACpD;CAEAxB,WAAWC,UAAUyB,QAAQ,SAC3BpB,MACAoB,OACArB,UAAwB,CAAC,GACE;EAsB3B,OAVgB,KAAKY,QAA0B;GAC7CC,IAAI;GACJC,MAAM;IACJb,MAAMZ,mBAAmBY,IAAI;IAC7BoB;IACSrB;GACX;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAaA,SAASC,OAAO;CACpD;CAEAxB,WAAWC,UAAU0B,cAAc,SACjCrB,MACAoB,OACArB,SACsC;EAsBtC,OAVgB,KAAKY,QAAqC;GACxDC,IAAI;GACJC,MAAM;IACJb,MAAMZ,mBAAmBY,IAAI;IAC7BoB;IACArB,SAASA,WAAW,CAAC;GACvB;GACAgB,cAAc,GAAG7B,YAAY,KAAK;EACpC,CAEOwB,CAAO,CAACM,MAAMC,aAAaA,SAASC,OAAO;CACpD;CAWAxB,WAAWC,UAAU2B,eAAe,SAAUzB,UAA6CC,IAAqB;EAM9G,IAAIyB;EACJ,IAAIC,UAAUC,WAAW,KAAKtC,kBAAkBU,QAAQ,GACtD0B,qBAAqB1B;OAChB;GACL,MAAMG,OAAOZ,mBAAmBS,QAAkB;GAClD,MAAMI,eAAelB,eAAee,EAAE;GACtCyB,qBAAqBzC,kBAAkBkB,MAAMC,YAAY;EAC3D;EAOA,MAAMC,aAA0B,KAAKC,gBAAgBC,4BAA4BmB,kBAAkB;EACnG1C,mBAAmB,IAAI;EAEvB,MAAM6C,QAAQC,sBAAsB,KAAKrB,eAAesB,WAAW,CAAC,CAACC;EACrE,IAAIA,YAAYH,MAAMI,IAAI5B,UAAU;EAEpC,IAAI,CAAC2B,WAAW;GACdA,YAAY,IAAItC,gBAAgB,MAAMW,UAAU;GAChDwB,MAAMK,IAAI7B,YAAY2B,SAAS;EACjC;EACA,OAAOA;CACT;CAEAnC,WAAWC,UAAUqC,WAAW,SAC9BhC,MACgB;EAKhB,OAAOX,aAAgB,MAAMW,IAAI;CACnC;CAEAN,WAAWC,UAAUsC,aAAa,SAAanB,QAAWf,UAAmC,CAAC,GAAe;EAM3G,MAAMG,aAAalB,oBAAoB8B,MAAM;EAC7C,MAAMY,QAAQ,KAAKA;EAEnB,IAAI,CAACxB,YAGH,OAAOgC,QAAQC,uBAAO,IAAIC,MAAM,wBAAwB,CAAC;EAE3DvD,mBAAmB,IAAI;EAKvB,IAAIW,uBAAuB,KAAKc,gBAAgBJ,UAAU,GACxD,OAAOgC,QAAQG,QAAQvB,MAAM;EAG/B,IAAI,CAACf,SACHA,UAAU,CAAC;EAEb,IAAIuC,YAA8D;EAElE,IAAIZ,MAAMa,MAAMrC,UAAU,GACxBoC,YAAY;OACP,IAAIZ,MAAMc,UAAUtC,UAAU,GACnCoC,YAAY;EAGd,MAAM3B,UAAU;GACdC,IAAI0B;GACJzB,MAAM;IACJd;IACAe,QAAQZ;GACV;GACAuC,SAAS,CAACvC,UAAU;GACpBa,cAAc,GAAG7B,YAAY,KAAK;EACpC;EAEA,OAAO,KAAKyB,QAAWA,OAAO,CAAC,CAACK,MAAMC,aAAaA,SAASC,OAAO;CACrE;AACF;AAKA,SAASS,sBAAsBD,OAA8E;CAC3G,MAAMgB,iBAAiBhB;CACvB,IAAI,CAACgB,eAAeb,WAClBa,eAAeb,4BAAY,IAAIc,QAAQ;CAGzC,OAAOD;AACT"}

package/dist/unpkg/prod/store.js

@@ -1,3 +1,3 @@
-import { t as restoreDeprecatedStoreBehaviors } from "./store-RGGc1ilN.js";
+import { t as restoreDeprecatedStoreBehaviors } from "./store-BsSkzWgk.js";
 
 export { restoreDeprecatedStoreBehaviors };

package/dist/unpkg/prod/{util-dSKEgQDp.js → util-CI7b4vAE.js}

@@ -1,4 +1,4 @@
-//#region src/model/-private/util.ts
+// src/model/-private/util.ts
 function isElementDescriptor(args) {
 	const [maybeTarget, maybeKey, maybeDesc] = args;
 	return args.length === 3 && (typeof maybeTarget === "function" || typeof maybeTarget === "object" && maybeTarget !== null) && typeof maybeKey === "string" && (typeof maybeDesc === "object" && maybeDesc !== null && "enumerable" in maybeDesc && "configurable" in maybeDesc || maybeDesc === void 0);
@@ -7,6 +7,5 @@ function normalizeModelName(type) {
 	return type;
 }
 
-//#endregion
 export { normalizeModelName as n, isElementDescriptor as t };
-//# sourceMappingURL=util-dSKEgQDp.js.map
+//# sourceMappingURL=util-CI7b4vAE.js.map

package/dist/unpkg/prod/{util-dSKEgQDp.js.map → util-CI7b4vAE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"util-dSKEgQDp.js","names":["dasherize","isElementDescriptor","args","maybeTarget","maybeKey","maybeDesc","length","undefined","normalizeModelName","type"],"sources":["../../../src/model/-private/util.ts"],"sourcesContent":["import { deprecate } from '@ember/debug';\n\nimport { DEPRECATE_NON_STRICT_TYPES } from '@warp-drive/core/build-config/deprecations';\nimport { dasherize } from '@warp-drive/utilities/string';\n\nexport type DecoratorPropertyDescriptor = (PropertyDescriptor & { initializer?: () => unknown }) | undefined;\n\nexport function isElementDescriptor(args: unknown[]): args is [object, string, DecoratorPropertyDescriptor] {\n  const [maybeTarget, maybeKey, maybeDesc] = args;\n\n  return (\n    // Ensure we have the right number of args\n    args.length === 3 &&\n    // Make sure the target is a class or object (prototype)\n    (typeof maybeTarget === 'function' || (typeof maybeTarget === 'object' && maybeTarget !== null)) &&\n    // Make sure the key is a string\n    typeof maybeKey === 'string' &&\n    // Make sure the descriptor is the right shape\n    ((typeof maybeDesc === 'object' &&\n      maybeDesc !== null &&\n      'enumerable' in maybeDesc &&\n      'configurable' in maybeDesc) ||\n      // TS compatibility\n      maybeDesc === undefined)\n  );\n}\n\nexport function normalizeModelName(type: string): string {\n  if (DEPRECATE_NON_STRICT_TYPES) {\n    const result = dasherize(type);\n\n    deprecate(\n      `The resource type '${type}' is not normalized. Update your application code to use '${result}' instead of '${type}'.`,\n      result === type,\n      {\n        id: 'ember-data:deprecate-non-strict-types',\n        until: '6.0',\n        for: 'ember-data',\n        since: {\n          available: '4.13',\n          enabled: '5.3',\n        },\n      }\n    );\n\n    return result;\n  }\n\n  return type;\n}\n"],"mappings":";AAOA,SAAgBC,oBAAoBC,MAAwE;CAC1G,MAAM,CAACC,aAAaC,UAAUC,aAAaH;CAE3C,OAEEA,KAAKI,WAAW,MAEf,OAAOH,gBAAgB,cAAe,OAAOA,gBAAgB,YAAYA,gBAAgB,SAE1F,OAAOC,aAAa,aAElB,OAAOC,cAAc,YACrBA,cAAc,QACd,gBAAgBA,aAChB,kBAAkBA,aAElBA,cAAcE;AAEpB;AAEA,SAAgBC,mBAAmBC,MAAsB;CAqBvD,OAAOA;AACT"}
+{"version":3,"file":"util-CI7b4vAE.js","names":["dasherize","isElementDescriptor","args","maybeTarget","maybeKey","maybeDesc","length","undefined","normalizeModelName","type"],"sources":["../../../src/model/-private/util.ts"],"sourcesContent":["import { deprecate } from '@ember/debug';\n\nimport { DEPRECATE_NON_STRICT_TYPES } from '@warp-drive/core/build-config/deprecations';\nimport { dasherize } from '@warp-drive/utilities/string';\n\nexport type DecoratorPropertyDescriptor = (PropertyDescriptor & { initializer?: () => unknown }) | undefined;\n\nexport function isElementDescriptor(args: unknown[]): args is [object, string, DecoratorPropertyDescriptor] {\n  const [maybeTarget, maybeKey, maybeDesc] = args;\n\n  return (\n    // Ensure we have the right number of args\n    args.length === 3 &&\n    // Make sure the target is a class or object (prototype)\n    (typeof maybeTarget === 'function' || (typeof maybeTarget === 'object' && maybeTarget !== null)) &&\n    // Make sure the key is a string\n    typeof maybeKey === 'string' &&\n    // Make sure the descriptor is the right shape\n    ((typeof maybeDesc === 'object' &&\n      maybeDesc !== null &&\n      'enumerable' in maybeDesc &&\n      'configurable' in maybeDesc) ||\n      // TS compatibility\n      maybeDesc === undefined)\n  );\n}\n\nexport function normalizeModelName(type: string): string {\n  if (DEPRECATE_NON_STRICT_TYPES) {\n    const result = dasherize(type);\n\n    deprecate(\n      `The resource type '${type}' is not normalized. Update your application code to use '${result}' instead of '${type}'.`,\n      result === type,\n      {\n        id: 'ember-data:deprecate-non-strict-types',\n        until: '6.0',\n        for: 'ember-data',\n        since: {\n          available: '4.13',\n          enabled: '5.3',\n        },\n      }\n    );\n\n    return result;\n  }\n\n  return type;\n}\n"],"mappings":";AAOA,SAAgBC,oBAAoBC,MAAwE;CAC1G,MAAM,CAACC,aAAaC,UAAUC,aAAaH;CAE3C,OAEEA,KAAKI,WAAW,MAEf,OAAOH,gBAAgB,cAAe,OAAOA,gBAAgB,YAAYA,gBAAgB,SAE1F,OAAOC,aAAa,aAElB,OAAOC,cAAc,YACrBA,cAAc,QACd,gBAAgBA,aAChB,kBAAkBA,aAElBA,cAAcE;AAEpB;AAEA,SAAgBC,mBAAmBC,MAAsB;CAqBvD,OAAOA;AACT"}

package/dist/unpkg/{dev/utils-DYC9utVJ.js → prod/utils-_O0MjUTU.js}

@@ -1,4 +1,4 @@
-//#region src/compat/builders/utils.ts
+// src/compat/builders/utils.ts
 function isMaybeIdentifier(maybeIdentifier) {
 	return Boolean(maybeIdentifier !== null && typeof maybeIdentifier === "object" && ("id" in maybeIdentifier && "type" in maybeIdentifier && maybeIdentifier.id && maybeIdentifier.type || maybeIdentifier.lid));
 }
@@ -6,6 +6,5 @@ function normalizeModelName(type) {
 	return type;
 }
 
-//#endregion
 export { normalizeModelName as n, isMaybeIdentifier as t };
-//# sourceMappingURL=utils-DYC9utVJ.js.map
+//# sourceMappingURL=utils-_O0MjUTU.js.map

package/dist/unpkg/prod/{utils-DYC9utVJ.js.map → utils-_O0MjUTU.js.map}

@@ -1 +1 @@
-{"version":3,"file":"utils-DYC9utVJ.js","names":["dasherize","isMaybeIdentifier","maybeIdentifier","Boolean","id","type","lid","normalizeModelName"],"sources":["../../../src/compat/builders/utils.ts"],"sourcesContent":["import { deprecate } from '@ember/debug';\n\nimport { DEPRECATE_NON_STRICT_TYPES } from '@warp-drive/core/build-config/deprecations';\nimport type { ResourceIdentifierObject } from '@warp-drive/core/types/spec/json-api-raw';\nimport { dasherize } from '@warp-drive/utilities/string';\n\nexport function isMaybeIdentifier(\n  maybeIdentifier: string | ResourceIdentifierObject\n): maybeIdentifier is ResourceIdentifierObject {\n  return Boolean(\n    maybeIdentifier !== null &&\n    typeof maybeIdentifier === 'object' &&\n    (('id' in maybeIdentifier && 'type' in maybeIdentifier && maybeIdentifier.id && maybeIdentifier.type) ||\n      maybeIdentifier.lid)\n  );\n}\n\nexport function normalizeModelName(type: string): string {\n  if (DEPRECATE_NON_STRICT_TYPES) {\n    const result = dasherize(type);\n\n    deprecate(\n      `The resource type '${type}' is not normalized. Update your application code to use '${result}' instead of '${type}'.`,\n      result === type,\n      {\n        id: 'ember-data:deprecate-non-strict-types',\n        until: '6.0',\n        for: 'ember-data',\n        since: {\n          available: '4.13',\n          enabled: '5.3',\n        },\n      }\n    );\n\n    return result;\n  }\n\n  return type;\n}\n"],"mappings":";AAMA,SAAgBC,kBACdC,iBAC6C;CAC7C,OAAOC,QACLD,oBAAoB,QACpB,OAAOA,oBAAoB,aACzB,QAAQA,mBAAmB,UAAUA,mBAAmBA,gBAAgBE,MAAMF,gBAAgBG,QAC9FH,gBAAgBI,IACpB;AACF;AAEA,SAAgBC,mBAAmBF,MAAsB;CAqBvD,OAAOA;AACT"}
+{"version":3,"file":"utils-_O0MjUTU.js","names":["dasherize","isMaybeIdentifier","maybeIdentifier","Boolean","id","type","lid","normalizeModelName"],"sources":["../../../src/compat/builders/utils.ts"],"sourcesContent":["import { deprecate } from '@ember/debug';\n\nimport { DEPRECATE_NON_STRICT_TYPES } from '@warp-drive/core/build-config/deprecations';\nimport type { ResourceIdentifierObject } from '@warp-drive/core/types/spec/json-api-raw';\nimport { dasherize } from '@warp-drive/utilities/string';\n\nexport function isMaybeIdentifier(\n  maybeIdentifier: string | ResourceIdentifierObject\n): maybeIdentifier is ResourceIdentifierObject {\n  return Boolean(\n    maybeIdentifier !== null &&\n    typeof maybeIdentifier === 'object' &&\n    (('id' in maybeIdentifier && 'type' in maybeIdentifier && maybeIdentifier.id && maybeIdentifier.type) ||\n      maybeIdentifier.lid)\n  );\n}\n\nexport function normalizeModelName(type: string): string {\n  if (DEPRECATE_NON_STRICT_TYPES) {\n    const result = dasherize(type);\n\n    deprecate(\n      `The resource type '${type}' is not normalized. Update your application code to use '${result}' instead of '${type}'.`,\n      result === type,\n      {\n        id: 'ember-data:deprecate-non-strict-types',\n        until: '6.0',\n        for: 'ember-data',\n        since: {\n          available: '4.13',\n          enabled: '5.3',\n        },\n      }\n    );\n\n    return result;\n  }\n\n  return type;\n}\n"],"mappings":";AAMA,SAAgBC,kBACdC,iBAC6C;CAC7C,OAAOC,QACLD,oBAAoB,QACpB,OAAOA,oBAAoB,aACzB,QAAQA,mBAAmB,UAAUA,mBAAmBA,gBAAgBE,MAAMF,gBAAgBG,QAC9FH,gBAAgBI,IACpB;AACF;AAEA,SAAgBC,mBAAmBF,MAAsB;CAqBvD,OAAOA;AACT"}