@warp-drive/legacy 5.10.0-alpha.10 → 5.10.0-alpha.13

package/dist/index.d.ts

@@ -26,6 +26,8 @@ interface _LegacyStoreSetupOptions<T extends Cache> extends Omit<StoreSetupOptio
  * Setup options for a legacy store configured to use `Model` with `linksMode`
  * enabled, meaning no legacy adapter/serializer request infrastructure is required.
  *
+ * @summary `useLegacyStore` options for a store that uses `Model` in `linksMode`, without the legacy adapter and
+ * serializer network layer.
  * @public
  */
 export interface LegacyModelStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {
@@ -53,6 +55,8 @@ export interface LegacyModelStoreSetupOptions<T extends Cache> extends _LegacySt
  * legacy adapter/serializer network layer, but without the deprecated
  * `store.findRecord`/`findAll`/`query`/etc. request methods.
  *
+ * @summary `useLegacyStore` options for a store that uses `Model` and the legacy adapter and serializer network
+ * layer, without deprecated request methods like `store.findRecord`.
  * @public
  */
 export interface LegacyModelAndNetworkStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {
@@ -78,6 +82,8 @@ export interface LegacyModelAndNetworkStoreSetupOptions<T extends Cache> extends
  * legacy adapter/serializer network layer and the deprecated
  * `store.findRecord`/`findAll`/`query`/etc. request methods.
  *
+ * @summary `useLegacyStore` options for a store that uses `Model`, the legacy adapter and serializer network layer,
+ * and deprecated request methods like `store.findRecord`.
  * @public
  */
 export interface LegacyModelAndNetworkAndRequestStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {
@@ -105,6 +111,9 @@ export interface LegacyModelAndNetworkAndRequestStoreSetupOptions<T extends Cach
  * - {@link LegacyModelStoreSetupOptions}
  * - {@link LegacyModelAndNetworkStoreSetupOptions}
  * - {@link LegacyModelAndNetworkAndRequestStoreSetupOptions}
+ *
+ * @summary Options accepted by `useLegacyStore`, choosing via `linksMode` and `legacyRequests` how much of the
+ * legacy `Model`, adapter, and request support to enable.
  */
 export type LegacyStoreSetupOptions<T extends Cache = Cache> = LegacyModelStoreSetupOptions<T> | LegacyModelAndNetworkStoreSetupOptions<T> | LegacyModelAndNetworkAndRequestStoreSetupOptions<T>;
 export declare class ConfiguredStore<T extends {
@@ -118,6 +127,10 @@ export declare class ConfiguredStore<T extends {
 /**
  * Use the legacy store with the given options.
  *
+ * See [Configure The Store](/guides/configuration/#configure-the-store) for where it fits in an
+ * app's setup, and [LegacyMode](/guides/the-manual/schemas/resources/legacy-mode) for the schemas
+ * it supports.
+ *
  * See {@link LegacyStoreSetupOptions} for details on the available options.
  *
  * ```ts
@@ -228,6 +241,9 @@ export declare class ConfiguredStore<T extends {
  * {@link RequestManager} won't have it set unless the caller supplies it
  * explicitly, so a handler relying on it should treat it as optional (as
  * `LoggingHandler` does above).
+ *
+ * @summary Creates a `Store` class preconfigured for legacy apps, with `Model` schema support, request handlers,
+ * cache, and optional adapter, serializer, and fragment support.
  */
 export declare function useLegacyStore<T extends Cache>(options: LegacyModelStoreSetupOptions<T>, StoreKlass?: typeof Store): typeof ConfiguredStore<{
   cache: T;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;UA2CU,yBAAyB,UAAU,eAAe,KAAK,kBAAkB;;;;;;;;;;;EAWjF,UAAU,MAAM,iBAAiB;;;;;;EAOjC;;;;;;;;iBASe,6BAA6B,UAAU,eAAe,yBAAyB;;;;;;;;;EAS9F;;;;;;;;;EASA;;;;;;;;;iBAUe,uCAAuC,UAAU,eAAe,yBAAyB;;;;;;;EAOxG;;;;;;;;;EASA;;;;;;;;;iBAUe,iDAAiD,UAAU,eAAe,yBAAyB;;;;;;;EAOlH;;;;;;;;;EASA;;;;;;;;;;YAaU,wBAAwB,UAAU,QAAQ,SAClD,6BAA6B,KAC7B,uCAAuC,KACvC,iDAAiD;qBAEhC,gBACnB;;;;EAIE,OAAO;WAED;EAER,YAAY,cAAc,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqHvC,eAAe,UAAU,OACvC,SAAS,6BAA6B,IACtC,oBAAoB,eACZ;EAAkB,OAAO;;wBACnB,eAAe,UAAU,OACvC,SAAS,uCAAuC,IAChD,oBAAoB,eACZ;EAAkB,OAAO;;wBACnB,eAAe,UAAU,OACvC,SAAS,iDAAiD,IAC1D,oBAAoB,eACZ;EAAkB,OAAO"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;UA6CU,yBAAyB,UAAU,eAAe,KAAK,kBAAkB;;;;;;;;;;;EAWjF,UAAU,MAAM,iBAAiB;;;;;;EAOjC;;;;;;;;;;iBAWe,6BAA6B,UAAU,eAAe,yBAAyB;;;;;;;;;EAS9F;;;;;;;;;EASA;;;;;;;;;;;iBAYe,uCAAuC,UAAU,eAAe,yBAAyB;;;;;;;EAOxG;;;;;;;;;EASA;;;;;;;;;;;iBAYe,iDAAiD,UAAU,eAAe,yBAAyB;;;;;;;EAOlH;;;;;;;;;EASA;;;;;;;;;;;;;YAgBU,wBAAwB,UAAU,QAAQ,SAClD,6BAA6B,KAC7B,uCAAuC,KACvC,iDAAiD;qBAEhC,gBACnB;;;;EAIE,OAAO;WAED;EAER,YAAY,cAAc,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4HvC,eAAe,UAAU,OACvC,SAAS,6BAA6B,IACtC,oBAAoB,eACZ;EAAkB,OAAO;;wBACnB,eAAe,UAAU,OACvC,SAAS,uCAAuC,IAChD,oBAAoB,eACZ;EAAkB,OAAO;;wBACnB,eAAe,UAAU,OACvC,SAAS,iDAAiD,IAC1D,oBAAoB,eACZ;EAAkB,OAAO"}

package/dist/index.js

@@ -1,10 +1,10 @@
-import { a as serializeRecord, i as pushPayload, n as cleanup, o as serializerFor, r as normalize, s as LegacyNetworkHandler, t as adapterFor } from "./compat-DWgmYX8T.js";
+import { a as serializeRecord, i as pushPayload, n as cleanup, o as serializerFor, r as normalize, s as LegacyNetworkHandler, t as adapterFor } from "./compat-Da5y9AsM.js";
 import { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension } from "./compat/extensions.js";
-import { n as modelFor, r as teardownRecord$1, t as instantiateRecord$1 } from "./model-C9l1mRs6.js";
-import { i as releaseLegacySupport } from "./errors-BlrR6--x.js";
-import { a as FragmentExtension, s as FragmentArrayExtension, t as fragmentsModelFor } from "./model-fragments-DSqu0ptR.js";
+import { n as modelFor, r as teardownRecord$1, t as instantiateRecord$1 } from "./model-DdlhdL9V.js";
+import { i as releaseLegacySupport } from "./errors-BI0Xugyo.js";
+import { a as FragmentExtension, s as FragmentArrayExtension, t as fragmentsModelFor } from "./model-fragments-ZM4k_mT3.js";
 import { DelegatingSchemaService, registerDerivations as registerDerivations$1 } from "./model/migration-support.js";
-import { t as restoreDeprecatedStoreBehaviors } from "./store-C4qYzXei.js";
+import { t as restoreDeprecatedStoreBehaviors } from "./store-CMUcaXRp.js";
 import { CacheHandler, Fetch, RequestManager, Store, recordIdentifierFor } from "@warp-drive/core";
 import { SchemaService, instantiateRecord, registerDerivations, teardownRecord } from "@warp-drive/core/reactive";
 import { DefaultCachePolicy } from "@warp-drive/core/store";
@@ -12,6 +12,8 @@ import { getGlobalConfig, macroCondition } from "@embroider/macros";
 
 //#region src/index.ts
 /**
+* @summary Legacy `Model`, adapter, and serializer support for WarpDrive, including `useLegacyStore` to configure a
+* store that uses them.
 * @module
 * @mergeModuleWith <project>
 */
@@ -19,6 +21,8 @@ import { getGlobalConfig, macroCondition } from "@embroider/macros";
 * Setup options for a legacy store configured to use `Model` with `linksMode`
 * enabled, meaning no legacy adapter/serializer request infrastructure is required.
 *
+* @summary `useLegacyStore` options for a store that uses `Model` in `linksMode`, without the legacy adapter and
+* serializer network layer.
 * @public
 */
 /**
@@ -26,6 +30,8 @@ import { getGlobalConfig, macroCondition } from "@embroider/macros";
 * legacy adapter/serializer network layer, but without the deprecated
 * `store.findRecord`/`findAll`/`query`/etc. request methods.
 *
+* @summary `useLegacyStore` options for a store that uses `Model` and the legacy adapter and serializer network
+* layer, without deprecated request methods like `store.findRecord`.
 * @public
 */
 /**
@@ -33,6 +39,8 @@ import { getGlobalConfig, macroCondition } from "@embroider/macros";
 * legacy adapter/serializer network layer and the deprecated
 * `store.findRecord`/`findAll`/`query`/etc. request methods.
 *
+* @summary `useLegacyStore` options for a store that uses `Model`, the legacy adapter and serializer network layer,
+* and deprecated request methods like `store.findRecord`.
 * @public
 */
 /**
@@ -42,10 +50,17 @@ import { getGlobalConfig, macroCondition } from "@embroider/macros";
 * - {@link LegacyModelStoreSetupOptions}
 * - {@link LegacyModelAndNetworkStoreSetupOptions}
 * - {@link LegacyModelAndNetworkAndRequestStoreSetupOptions}
+*
+* @summary Options accepted by `useLegacyStore`, choosing via `linksMode` and `legacyRequests` how much of the
+* legacy `Model`, adapter, and request support to enable.
 */
 /**
 * Use the legacy store with the given options.
 *
+* See [Configure The Store](/guides/configuration/#configure-the-store) for where it fits in an
+* app's setup, and [LegacyMode](/guides/the-manual/schemas/resources/legacy-mode) for the schemas
+* it supports.
+*
 * See {@link LegacyStoreSetupOptions} for details on the available options.
 *
 * ```ts
@@ -156,6 +171,9 @@ import { getGlobalConfig, macroCondition } from "@embroider/macros";
 * {@link RequestManager} won't have it set unless the caller supplies it
 * explicitly, so a handler relying on it should treat it as optional (as
 * `LoggingHandler` does above).
+*
+* @summary Creates a `Store` class preconfigured for legacy apps, with `Model` schema support, request handlers,
+* cache, and optional adapter, serializer, and fragment support.
 */
 function useLegacyStore(options, StoreKlass = Store) {
 	macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) && ((test) => {
@@ -232,6 +250,7 @@ function useLegacyStore(options, StoreKlass = Store) {
 			return modelFor.call(this, type) || (options.modelFragments ? fragmentsModelFor.call(this, type) : false) || super.modelFor(type);
 		}
 		adapterFor(modelName, _allowMissing) {
+			if (options.linksMode && _allowMissing) return;
 			macroCondition(getGlobalConfig().WarpDrive.env.DEBUG) && ((test) => {
 				if (!test) throw new Error(`useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`);
 			})(!options.linksMode);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["CacheHandler","Fetch","recordIdentifierFor","RequestManager","Store","instantiateRecord","registerDerivations","SchemaService","teardownRecord","DefaultCachePolicy","adapterFor","cleanup","LegacyNetworkHandler","normalize","pushPayload","serializeRecord","serializerFor","EmberArrayLikeExtension","EmberObjectArrayExtension","EmberObjectExtension","instantiateModel","modelFor","teardownModel","FragmentArrayExtension","FragmentExtension","fragmentsModelFor","releaseLegacySupport","DelegatingSchemaService","registerLegacyDerivations","restoreDeprecatedStoreBehaviors","macroCondition","getGlobalConfig","useLegacyStore","options","StoreKlass","WarpDrive","env","DEBUG","test","Error","linksMode","legacyRequests","BaseKlass","LegacyConfiguredStore","constructor","createArgs","requestManager","Object","defineProperty","configurable","enumerable","get","handlersOption","handlers","use","filter","Boolean","useCache","set","value","lifetimes","policy","apiCacheHardExpires","apiCacheSoftExpires","constraints","headers","Expires","createSchemaService","schema","schemas","registerResources","traits","trait","registerTrait","derivations","derivation","registerDerivation","transformations","transformation","registerTransformation","hashFns","hashFn","registerHashFn","CAUTION_MEGA_DANGER_ZONE_extensions","extension","CAUTION_MEGA_DANGER_ZONE_registerExtension","modelFragments","createCache","capabilities","cache","key","isDelegated","call","record","type","assertType","klass","modelName","_allowMissing","args","destroy","hasResource"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @module\n * @mergeModuleWith <project>\n */\n\nimport {\n  CacheHandler,\n  Fetch,\n  recordIdentifierFor,\n  RequestManager,\n  Store,\n  type StoreSetupOptions,\n} from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { instantiateRecord, registerDerivations, SchemaService, teardownRecord } from '@warp-drive/core/reactive';\nimport type { Handler } from '@warp-drive/core/request';\nimport { DefaultCachePolicy } from '@warp-drive/core/store';\nimport type { CacheCapabilitiesManager, ModelSchema, ResourceKey } from '@warp-drive/core/types';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { TypeFromInstance } from '@warp-drive/core/types/record';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestInfo } from '@warp-drive/core/types/request';\nimport type { ObjectSchema, ResourceSchema } from '@warp-drive/core/types/schema/fields';\n\nimport type { MinimumAdapterInterface } from './compat';\nimport {\n  adapterFor,\n  cleanup,\n  LegacyNetworkHandler,\n  normalize,\n  pushPayload,\n  serializeRecord,\n  serializerFor,\n} from './compat';\nimport { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension } from './compat/extensions';\nimport type Model from './model';\nimport { instantiateRecord as instantiateModel, modelFor, teardownRecord as teardownModel } from './model';\nimport { FragmentArrayExtension, FragmentExtension } from './model-fragments';\nimport { fragmentsModelFor } from './model-fragments/hooks/model-for';\nimport { releaseLegacySupport } from './model/-private/legacy-relationships-support';\nimport { DelegatingSchemaService, registerDerivations as registerLegacyDerivations } from './model/migration-support';\nimport { restoreDeprecatedStoreBehaviors } from './store';\n\ninterface _LegacyStoreSetupOptions<T extends Cache> extends Omit<StoreSetupOptions<T>, 'schemas'> {\n  /**\n   * The {@link ResourceSchema | ResourceSchemas} or {@link ObjectSchema | ObjectSchemas} of entities\n   * migrated to no longer use {@link Model}.\n   *\n   * :::caution\n   * {@link Model} is still able to be used directly as a source of schema when using {@link useLegacyStore},\n   * however, its reliance on EmberObject, classic computeds and resolver behaviors mean that Model\n   * will stop working when these things are deprecated in Ember.\n   * :::\n   */\n  schemas?: Array<ResourceSchema | ObjectSchema>;\n\n  /**\n   * Whether to include support for ModelFragments migrations.\n   *\n   * @default false\n   */\n  modelFragments?: boolean;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` with `linksMode`\n * enabled, meaning no legacy adapter/serializer request infrastructure is required.\n *\n * @public\n */\nexport interface LegacyModelStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  linksMode: true;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests?: false;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` along with the\n * legacy adapter/serializer network layer, but without the deprecated\n * `store.findRecord`/`findAll`/`query`/etc. request methods.\n *\n * @public\n */\nexport interface LegacyModelAndNetworkStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * @default false\n   */\n  linksMode: false;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests?: false;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` along with the\n * legacy adapter/serializer network layer and the deprecated\n * `store.findRecord`/`findAll`/`query`/etc. request methods.\n *\n * @public\n */\nexport interface LegacyModelAndNetworkAndRequestStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * @default false\n   */\n  linksMode: false;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests: true;\n}\n\n//export type ConfiguredStore<T = unknown> = typeof Store;\n\n/**\n * The available options when setting up the legacy store,\n * one of:\n *\n * - {@link LegacyModelStoreSetupOptions}\n * - {@link LegacyModelAndNetworkStoreSetupOptions}\n * - {@link LegacyModelAndNetworkAndRequestStoreSetupOptions}\n */\nexport type LegacyStoreSetupOptions<T extends Cache = Cache> =\n  | LegacyModelStoreSetupOptions<T>\n  | LegacyModelAndNetworkStoreSetupOptions<T>\n  | LegacyModelAndNetworkAndRequestStoreSetupOptions<T>;\n\nexport declare class ConfiguredStore<\n  T extends {\n    /**\n     * The {@link Cache} implementation this store was configured with.\n     */\n    cache: Cache;\n  },\n> extends Store {\n  // get cache(): T extends OptionsWithCache<infer R> ? R : never;\n  createCache(capabilities: CacheCapabilitiesManager): T['cache'];\n}\n\n/**\n * Use the legacy store with the given options.\n *\n * See {@link LegacyStoreSetupOptions} for details on the available options.\n *\n * ```ts\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   schemas: [],\n * });\n * ```\n *\n * ### Adding Stateful Handlers\n *\n * A request {@link Handler} is sometimes more than a plain object or class\n * with a `request` method — it may need access to a stateful dependency such\n * as an Ember service (an auth token, a feature-flags service, an i18n\n * helper, etc.).\n *\n * A plain class handler that only relies on Ember's `@service` decorator will\n * not work here on its own: the handler is never instantiated *through*\n * Ember's container (it's just `new`'d up), so it has no owner and its\n * `@service` injections would fail to resolve.\n *\n * Instead, give `handlers` a function. It receives the {@link Store} instance\n * being configured, which by the time the function runs already has an owner\n * assigned. Use `getOwner`/`setOwner` from `@ember/owner` to transfer that\n * owner onto your handler instance before returning it, exactly as you would\n * when constructing any other DI-aware object outside of the container:\n *\n * ```ts\n * import { getOwner, setOwner } from '@ember/owner';\n * import { service } from '@ember/service';\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import type { NextFn } from '@warp-drive/core/request';\n * import type { RequestContext } from '@warp-drive/core/types/request';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * class AuthHandler {\n *   @service session;\n *\n *   request<T>(context: RequestContext, next: NextFn<T>) {\n *     const headers = new Headers(context.request.headers);\n *     headers.append('Authorization', `Bearer ${this.session.accessToken}`);\n *     return next(Object.assign({}, context.request, { headers }));\n *   }\n * }\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   handlers: (store) => {\n *     const authHandler = new AuthHandler();\n *     setOwner(authHandler, getOwner(store)!);\n *     return [authHandler];\n *   },\n * });\n * ```\n *\n * The `handlers` function is invoked lazily and only once per store instance,\n * the first time `store.requestManager` is accessed, so it is safe to do\n * owner-dependent setup like this inside of it.\n *\n * ### Accessing the Store from a Handler's Context\n *\n * If a handler only needs to read something *off of the store itself*\n * (its cache, or a property/service you've attached to a custom store\n * subclass) rather than an unrelated Ember service, there is a second,\n * simpler option that requires no DI/`setOwner` wiring at all.\n *\n * Every request issued via {@link Store.request | store.request(...)}\n * automatically carries the originating store along as\n * {@link RequestInfo.store | context.request.store}. Any handler — a plain\n * object, a function-built handler, or a class — can read it directly,\n * without needing the `handlers` callback form shown above:\n *\n * ```ts\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import type { NextFn } from '@warp-drive/core/request';\n * import type { RequestContext } from '@warp-drive/core/types/request';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * const LoggingHandler = {\n *   request<T>(context: RequestContext, next: NextFn<T>) {\n *     // only present when the request was made via `store.request(...)`\n *     const store = context.request.store;\n *     if (store) {\n *       console.log(`[${store.constructor.name}] ${context.request.url ?? ''}`);\n *     }\n *     return next(context.request);\n *   },\n * };\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   handlers: [LoggingHandler],\n * });\n * ```\n *\n * The trade-off versus the `getOwner`/`setOwner` pattern above is that\n * `context.request.store` is only populated for requests issued via\n * `store.request(...)`; a request made directly against a\n * {@link RequestManager} won't have it set unless the caller supplies it\n * explicitly, so a handler relying on it should treat it as optional (as\n * `LoggingHandler` does above).\n */\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelAndNetworkStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelAndNetworkAndRequestStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyStoreSetupOptions<T>,\n  StoreKlass: typeof Store = Store\n): typeof ConfiguredStore<{ cache: T }> {\n  assert(`If legacyRequests is true, linksMode must be false`, !(options.linksMode && options.legacyRequests));\n  // we extend the store to ensure we don't leak our prototype overrides to other stores below.\n  class BaseKlass extends StoreKlass {}\n  class LegacyConfiguredStore extends BaseKlass {\n    constructor(createArgs?: unknown) {\n      super(createArgs);\n      // installed via defineProperty (rather than a class field/accessor) so that\n      // this lazy override of the inherited `requestManager` field does not\n      // conflict with the documented pattern of assigning it directly on\n      // consumer-authored Store subclasses. The setter preserves the ability\n      // to replace `requestManager` outright after construction.\n      let requestManager: RequestManager | undefined;\n      Object.defineProperty(this, 'requestManager', {\n        configurable: true,\n        enumerable: true,\n        get: (): RequestManager => {\n          if (!requestManager) {\n            const handlersOption = options.handlers;\n            const handlers = typeof handlersOption === 'function' ? handlersOption(this) : (handlersOption ?? []);\n            requestManager = new RequestManager()\n              .use([options.linksMode ? null : LegacyNetworkHandler, ...handlers, Fetch].filter(Boolean) as Handler[])\n              .useCache(CacheHandler);\n          }\n          return requestManager;\n        },\n        set: (value: RequestManager): void => {\n          requestManager = value;\n        },\n      });\n    }\n\n    lifetimes =\n      options.policy ??\n      new DefaultCachePolicy({\n        apiCacheHardExpires: 15 * 60 * 1000, // 15 minutes\n        apiCacheSoftExpires: 1 * 30 * 1000, // 30 seconds\n        constraints: {\n          headers: {\n            'X-WarpDrive-Expires': true,\n            'Cache-Control': true,\n            Expires: true,\n          },\n        },\n      });\n\n    createSchemaService(): DelegatingSchemaService {\n      // prepare for PolarisMode\n      const schema = new SchemaService();\n      registerDerivations(schema);\n      if (options.schemas) schema.registerResources(options.schemas);\n\n      if (options.traits) {\n        for (const trait of options.traits) {\n          schema.registerTrait(trait);\n        }\n      }\n\n      if (options.derivations) {\n        for (const derivation of options.derivations) {\n          schema.registerDerivation(derivation);\n        }\n      }\n\n      if (options.transformations) {\n        for (const transformation of options.transformations) {\n          schema.registerTransformation(transformation);\n        }\n      }\n\n      if (options.hashFns) {\n        for (const hashFn of options.hashFns) {\n          schema.registerHashFn(hashFn);\n        }\n      }\n\n      if (options.CAUTION_MEGA_DANGER_ZONE_extensions) {\n        for (const extension of options.CAUTION_MEGA_DANGER_ZONE_extensions) {\n          schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(extension);\n        }\n      }\n\n      // Add support for LegacyMode ReactiveResource with Maximal coverage\n      // for upgrading from 4.x\n      registerLegacyDerivations(schema);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberArrayLikeExtension);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectArrayExtension);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectExtension);\n\n      // add support for fragments\n      if (options.modelFragments) {\n        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentExtension);\n        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentArrayExtension);\n      }\n\n      // Add fallback for Models\n      return new DelegatingSchemaService(this, schema);\n    }\n\n    createCache(capabilities: CacheCapabilitiesManager) {\n      // oxlint-disable-next-line new-cap\n      return new options.cache(capabilities);\n    }\n\n    instantiateRecord(key: ResourceKey, createArgs?: Record<string, unknown>) {\n      if (this.schema.isDelegated(key)) {\n        return instantiateModel.call(this, key, createArgs);\n      }\n      return instantiateRecord(this, key, createArgs);\n    }\n\n    teardownRecord(record: unknown): void {\n      const key = recordIdentifierFor(record);\n      if (this.schema.isDelegated(key)) {\n        return teardownModel.call(this, record as Model);\n      }\n      releaseLegacySupport(key);\n      return teardownRecord(record);\n    }\n\n    modelFor<InstanceType>(type: TypeFromInstance<InstanceType>): ModelSchema<InstanceType>;\n    modelFor(type: string): ModelSchema;\n    modelFor(type: string): ModelSchema {\n      assertType(this.schema, type);\n\n      const klass =\n        // prefer real models if present\n        (modelFor.call(this, type) as ModelSchema) ||\n        // fallback to ShimModelClass specific to fragments if fragments support in use\n        (options.modelFragments ? (fragmentsModelFor.call(this, type) as ModelSchema) : false) ||\n        // fallback to ShimModelClass\n        super.modelFor(type);\n\n      return klass;\n    }\n\n    adapterFor(this: Store, modelName: string): MinimumAdapterInterface;\n    adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;\n    adapterFor(this: Store, modelName: string, _allowMissing?: true): MinimumAdapterInterface | undefined {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      // @ts-expect-error\n      return adapterFor.call(this, modelName, _allowMissing);\n    }\n\n    serializerFor(this: Store, ...args: Parameters<typeof serializerFor>): ReturnType<typeof serializerFor> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return serializerFor.call(this, ...args);\n    }\n\n    pushPayload(this: Store, ...args: Parameters<typeof pushPayload>): ReturnType<typeof pushPayload> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return pushPayload.call(this, ...args);\n    }\n\n    normalize(this: Store, ...args: Parameters<typeof normalize>): ReturnType<typeof normalize> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return normalize.call(this, ...args);\n    }\n\n    serializeRecord(this: Store, ...args: Parameters<typeof serializeRecord>): ReturnType<typeof serializeRecord> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return serializeRecord.call(this, ...args);\n    }\n\n    destroy() {\n      if (!options.linksMode) {\n        cleanup.call(this);\n      }\n      super.destroy();\n    }\n  }\n\n  if (options.legacyRequests) {\n    restoreDeprecatedStoreBehaviors(BaseKlass);\n  }\n\n  return LegacyConfiguredStore;\n}\n\nfunction assertType(schema: DelegatingSchemaService, type: string) {\n  assert(`Expected type ${type} to be a valid ResourceType`, schema.hasResource({ type }));\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["CacheHandler","Fetch","recordIdentifierFor","RequestManager","Store","instantiateRecord","registerDerivations","SchemaService","teardownRecord","DefaultCachePolicy","adapterFor","cleanup","LegacyNetworkHandler","normalize","pushPayload","serializeRecord","serializerFor","EmberArrayLikeExtension","EmberObjectArrayExtension","EmberObjectExtension","instantiateModel","modelFor","teardownModel","FragmentArrayExtension","FragmentExtension","fragmentsModelFor","releaseLegacySupport","DelegatingSchemaService","registerLegacyDerivations","restoreDeprecatedStoreBehaviors","macroCondition","getGlobalConfig","useLegacyStore","options","StoreKlass","WarpDrive","env","DEBUG","test","Error","linksMode","legacyRequests","BaseKlass","LegacyConfiguredStore","constructor","createArgs","requestManager","Object","defineProperty","configurable","enumerable","get","handlersOption","handlers","use","filter","Boolean","useCache","set","value","lifetimes","policy","apiCacheHardExpires","apiCacheSoftExpires","constraints","headers","Expires","createSchemaService","schema","schemas","registerResources","traits","trait","registerTrait","derivations","derivation","registerDerivation","transformations","transformation","registerTransformation","hashFns","hashFn","registerHashFn","CAUTION_MEGA_DANGER_ZONE_extensions","extension","CAUTION_MEGA_DANGER_ZONE_registerExtension","modelFragments","createCache","capabilities","cache","key","isDelegated","call","record","type","assertType","klass","modelName","_allowMissing","undefined","args","destroy","hasResource","instantiateModel","teardownModel"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @summary Legacy `Model`, adapter, and serializer support for WarpDrive, including `useLegacyStore` to configure a\n * store that uses them.\n * @module\n * @mergeModuleWith <project>\n */\n\nimport {\n  CacheHandler,\n  Fetch,\n  recordIdentifierFor,\n  RequestManager,\n  Store,\n  type StoreSetupOptions,\n} from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { instantiateRecord, registerDerivations, SchemaService, teardownRecord } from '@warp-drive/core/reactive';\nimport type { Handler } from '@warp-drive/core/request';\nimport { DefaultCachePolicy } from '@warp-drive/core/store';\nimport type { CacheCapabilitiesManager, ModelSchema, ResourceKey } from '@warp-drive/core/types';\nimport type { Cache } from '@warp-drive/core/types/cache';\nimport type { TypeFromInstance } from '@warp-drive/core/types/record';\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestInfo } from '@warp-drive/core/types/request';\nimport type { ObjectSchema, ResourceSchema } from '@warp-drive/core/types/schema/fields';\n\nimport type { MinimumAdapterInterface } from './compat';\nimport {\n  adapterFor,\n  cleanup,\n  LegacyNetworkHandler,\n  normalize,\n  pushPayload,\n  serializeRecord,\n  serializerFor,\n} from './compat';\nimport { EmberArrayLikeExtension, EmberObjectArrayExtension, EmberObjectExtension } from './compat/extensions';\nimport type Model from './model';\nimport { instantiateRecord as instantiateModel, modelFor, teardownRecord as teardownModel } from './model';\nimport { FragmentArrayExtension, FragmentExtension } from './model-fragments';\nimport { fragmentsModelFor } from './model-fragments/hooks/model-for';\nimport { releaseLegacySupport } from './model/-private/legacy-relationships-support';\nimport { DelegatingSchemaService, registerDerivations as registerLegacyDerivations } from './model/migration-support';\nimport { restoreDeprecatedStoreBehaviors } from './store';\n\ninterface _LegacyStoreSetupOptions<T extends Cache> extends Omit<StoreSetupOptions<T>, 'schemas'> {\n  /**\n   * The {@link ResourceSchema | ResourceSchemas} or {@link ObjectSchema | ObjectSchemas} of entities\n   * migrated to no longer use {@link Model}.\n   *\n   * :::caution\n   * {@link Model} is still able to be used directly as a source of schema when using {@link useLegacyStore},\n   * however, its reliance on EmberObject, classic computeds and resolver behaviors mean that Model\n   * will stop working when these things are deprecated in Ember.\n   * :::\n   */\n  schemas?: Array<ResourceSchema | ObjectSchema>;\n\n  /**\n   * Whether to include support for ModelFragments migrations.\n   *\n   * @default false\n   */\n  modelFragments?: boolean;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` with `linksMode`\n * enabled, meaning no legacy adapter/serializer request infrastructure is required.\n *\n * @summary `useLegacyStore` options for a store that uses `Model` in `linksMode`, without the legacy adapter and\n * serializer network layer.\n * @public\n */\nexport interface LegacyModelStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  linksMode: true;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests?: false;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` along with the\n * legacy adapter/serializer network layer, but without the deprecated\n * `store.findRecord`/`findAll`/`query`/etc. request methods.\n *\n * @summary `useLegacyStore` options for a store that uses `Model` and the legacy adapter and serializer network\n * layer, without deprecated request methods like `store.findRecord`.\n * @public\n */\nexport interface LegacyModelAndNetworkStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * @default false\n   */\n  linksMode: false;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests?: false;\n}\n\n/**\n * Setup options for a legacy store configured to use `Model` along with the\n * legacy adapter/serializer network layer and the deprecated\n * `store.findRecord`/`findAll`/`query`/etc. request methods.\n *\n * @summary `useLegacyStore` options for a store that uses `Model`, the legacy adapter and serializer network layer,\n * and deprecated request methods like `store.findRecord`.\n * @public\n */\nexport interface LegacyModelAndNetworkAndRequestStoreSetupOptions<T extends Cache> extends _LegacyStoreSetupOptions<T> {\n  /**\n   * If true, it is presumed that no requests require use of the LegacyNetworkHandler\n   * and associated adapters/serializer methods.\n   *\n   * @default false\n   */\n  linksMode: false;\n  /**\n   * if true, all legacy request methods and supporting infrastructure will\n   * be available on the store.\n   *\n   * If legacyRequests is true, {@link linksMode} must be false\n   *\n   * @default false\n   */\n  legacyRequests: true;\n}\n\n//export type ConfiguredStore<T = unknown> = typeof Store;\n\n/**\n * The available options when setting up the legacy store,\n * one of:\n *\n * - {@link LegacyModelStoreSetupOptions}\n * - {@link LegacyModelAndNetworkStoreSetupOptions}\n * - {@link LegacyModelAndNetworkAndRequestStoreSetupOptions}\n *\n * @summary Options accepted by `useLegacyStore`, choosing via `linksMode` and `legacyRequests` how much of the\n * legacy `Model`, adapter, and request support to enable.\n */\nexport type LegacyStoreSetupOptions<T extends Cache = Cache> =\n  | LegacyModelStoreSetupOptions<T>\n  | LegacyModelAndNetworkStoreSetupOptions<T>\n  | LegacyModelAndNetworkAndRequestStoreSetupOptions<T>;\n\nexport declare class ConfiguredStore<\n  T extends {\n    /**\n     * The {@link Cache} implementation this store was configured with.\n     */\n    cache: Cache;\n  },\n> extends Store {\n  // get cache(): T extends OptionsWithCache<infer R> ? R : never;\n  createCache(capabilities: CacheCapabilitiesManager): T['cache'];\n}\n\n/**\n * Use the legacy store with the given options.\n *\n * See [Configure The Store](/guides/configuration/#configure-the-store) for where it fits in an\n * app's setup, and [LegacyMode](/guides/the-manual/schemas/resources/legacy-mode) for the schemas\n * it supports.\n *\n * See {@link LegacyStoreSetupOptions} for details on the available options.\n *\n * ```ts\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   schemas: [],\n * });\n * ```\n *\n * ### Adding Stateful Handlers\n *\n * A request {@link Handler} is sometimes more than a plain object or class\n * with a `request` method — it may need access to a stateful dependency such\n * as an Ember service (an auth token, a feature-flags service, an i18n\n * helper, etc.).\n *\n * A plain class handler that only relies on Ember's `@service` decorator will\n * not work here on its own: the handler is never instantiated *through*\n * Ember's container (it's just `new`'d up), so it has no owner and its\n * `@service` injections would fail to resolve.\n *\n * Instead, give `handlers` a function. It receives the {@link Store} instance\n * being configured, which by the time the function runs already has an owner\n * assigned. Use `getOwner`/`setOwner` from `@ember/owner` to transfer that\n * owner onto your handler instance before returning it, exactly as you would\n * when constructing any other DI-aware object outside of the container:\n *\n * ```ts\n * import { getOwner, setOwner } from '@ember/owner';\n * import { service } from '@ember/service';\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import type { NextFn } from '@warp-drive/core/request';\n * import type { RequestContext } from '@warp-drive/core/types/request';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * class AuthHandler {\n *   @service session;\n *\n *   request<T>(context: RequestContext, next: NextFn<T>) {\n *     const headers = new Headers(context.request.headers);\n *     headers.append('Authorization', `Bearer ${this.session.accessToken}`);\n *     return next(Object.assign({}, context.request, { headers }));\n *   }\n * }\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   handlers: (store) => {\n *     const authHandler = new AuthHandler();\n *     setOwner(authHandler, getOwner(store)!);\n *     return [authHandler];\n *   },\n * });\n * ```\n *\n * The `handlers` function is invoked lazily and only once per store instance,\n * the first time `store.requestManager` is accessed, so it is safe to do\n * owner-dependent setup like this inside of it.\n *\n * ### Accessing the Store from a Handler's Context\n *\n * If a handler only needs to read something *off of the store itself*\n * (its cache, or a property/service you've attached to a custom store\n * subclass) rather than an unrelated Ember service, there is a second,\n * simpler option that requires no DI/`setOwner` wiring at all.\n *\n * Every request issued via {@link Store.request | store.request(...)}\n * automatically carries the originating store along as\n * {@link RequestInfo.store | context.request.store}. Any handler — a plain\n * object, a function-built handler, or a class — can read it directly,\n * without needing the `handlers` callback form shown above:\n *\n * ```ts\n * import { useLegacyStore } from '@warp-drive/legacy';\n * import type { NextFn } from '@warp-drive/core/request';\n * import type { RequestContext } from '@warp-drive/core/types/request';\n * import { JSONAPICache } from '@warp-drive/json-api';\n *\n * const LoggingHandler = {\n *   request<T>(context: RequestContext, next: NextFn<T>) {\n *     // only present when the request was made via `store.request(...)`\n *     const store = context.request.store;\n *     if (store) {\n *       console.log(`[${store.constructor.name}] ${context.request.url ?? ''}`);\n *     }\n *     return next(context.request);\n *   },\n * };\n *\n * export default useLegacyStore({\n *   linksMode: false,\n *   legacyRequests: true,\n *   cache: JSONAPICache,\n *   handlers: [LoggingHandler],\n * });\n * ```\n *\n * The trade-off versus the `getOwner`/`setOwner` pattern above is that\n * `context.request.store` is only populated for requests issued via\n * `store.request(...)`; a request made directly against a\n * {@link RequestManager} won't have it set unless the caller supplies it\n * explicitly, so a handler relying on it should treat it as optional (as\n * `LoggingHandler` does above).\n *\n * @summary Creates a `Store` class preconfigured for legacy apps, with `Model` schema support, request handlers,\n * cache, and optional adapter, serializer, and fragment support.\n */\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelAndNetworkStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyModelAndNetworkAndRequestStoreSetupOptions<T>,\n  StoreKlass?: typeof Store\n): typeof ConfiguredStore<{ cache: T }>;\nexport function useLegacyStore<T extends Cache>(\n  options: LegacyStoreSetupOptions<T>,\n  StoreKlass: typeof Store = Store\n): typeof ConfiguredStore<{ cache: T }> {\n  assert(`If legacyRequests is true, linksMode must be false`, !(options.linksMode && options.legacyRequests));\n  // we extend the store to ensure we don't leak our prototype overrides to other stores below.\n  class BaseKlass extends StoreKlass {}\n  class LegacyConfiguredStore extends BaseKlass {\n    constructor(createArgs?: unknown) {\n      super(createArgs);\n      // installed via defineProperty (rather than a class field/accessor) so that\n      // this lazy override of the inherited `requestManager` field does not\n      // conflict with the documented pattern of assigning it directly on\n      // consumer-authored Store subclasses. The setter preserves the ability\n      // to replace `requestManager` outright after construction.\n      let requestManager: RequestManager | undefined;\n      Object.defineProperty(this, 'requestManager', {\n        configurable: true,\n        enumerable: true,\n        get: (): RequestManager => {\n          if (!requestManager) {\n            const handlersOption = options.handlers;\n            const handlers = typeof handlersOption === 'function' ? handlersOption(this) : (handlersOption ?? []);\n            requestManager = new RequestManager()\n              .use([options.linksMode ? null : LegacyNetworkHandler, ...handlers, Fetch].filter(Boolean) as Handler[])\n              .useCache(CacheHandler);\n          }\n          return requestManager;\n        },\n        set: (value: RequestManager): void => {\n          requestManager = value;\n        },\n      });\n    }\n\n    lifetimes =\n      options.policy ??\n      new DefaultCachePolicy({\n        apiCacheHardExpires: 15 * 60 * 1000, // 15 minutes\n        apiCacheSoftExpires: 1 * 30 * 1000, // 30 seconds\n        constraints: {\n          headers: {\n            'X-WarpDrive-Expires': true,\n            'Cache-Control': true,\n            Expires: true,\n          },\n        },\n      });\n\n    createSchemaService(): DelegatingSchemaService {\n      // prepare for PolarisMode\n      const schema = new SchemaService();\n      registerDerivations(schema);\n      if (options.schemas) schema.registerResources(options.schemas);\n\n      if (options.traits) {\n        for (const trait of options.traits) {\n          schema.registerTrait(trait);\n        }\n      }\n\n      if (options.derivations) {\n        for (const derivation of options.derivations) {\n          schema.registerDerivation(derivation);\n        }\n      }\n\n      if (options.transformations) {\n        for (const transformation of options.transformations) {\n          schema.registerTransformation(transformation);\n        }\n      }\n\n      if (options.hashFns) {\n        for (const hashFn of options.hashFns) {\n          schema.registerHashFn(hashFn);\n        }\n      }\n\n      if (options.CAUTION_MEGA_DANGER_ZONE_extensions) {\n        for (const extension of options.CAUTION_MEGA_DANGER_ZONE_extensions) {\n          schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(extension);\n        }\n      }\n\n      // Add support for LegacyMode ReactiveResource with Maximal coverage\n      // for upgrading from 4.x\n      registerLegacyDerivations(schema);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberArrayLikeExtension);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectArrayExtension);\n      schema.CAUTION_MEGA_DANGER_ZONE_registerExtension(EmberObjectExtension);\n\n      // add support for fragments\n      if (options.modelFragments) {\n        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentExtension);\n        schema.CAUTION_MEGA_DANGER_ZONE_registerExtension?.(FragmentArrayExtension);\n      }\n\n      // Add fallback for Models\n      return new DelegatingSchemaService(this, schema);\n    }\n\n    createCache(capabilities: CacheCapabilitiesManager) {\n      // oxlint-disable-next-line new-cap\n      return new options.cache(capabilities);\n    }\n\n    instantiateRecord(key: ResourceKey, createArgs?: Record<string, unknown>) {\n      if (this.schema.isDelegated(key)) {\n        return instantiateModel.call(this, key, createArgs);\n      }\n      return instantiateRecord(this, key, createArgs);\n    }\n\n    teardownRecord(record: unknown): void {\n      const key = recordIdentifierFor(record);\n      if (this.schema.isDelegated(key)) {\n        return teardownModel.call(this, record as Model);\n      }\n      releaseLegacySupport(key);\n      return teardownRecord(record);\n    }\n\n    modelFor<InstanceType>(type: TypeFromInstance<InstanceType>): ModelSchema<InstanceType>;\n    modelFor(type: string): ModelSchema;\n    modelFor(type: string): ModelSchema {\n      assertType(this.schema, type);\n\n      const klass =\n        // prefer real models if present\n        (modelFor.call(this, type) as ModelSchema) ||\n        // fallback to ShimModelClass specific to fragments if fragments support in use\n        (options.modelFragments ? (fragmentsModelFor.call(this, type) as ModelSchema) : false) ||\n        // fallback to ShimModelClass\n        super.modelFor(type);\n\n      return klass;\n    }\n\n    adapterFor(this: Store, modelName: string): MinimumAdapterInterface;\n    adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;\n    adapterFor(this: Store, modelName: string, _allowMissing?: true): MinimumAdapterInterface | undefined {\n      // createRecord asks for an adapter with _allowMissing to offer id generation;\n      // linksMode has no adapters, so that soft lookup finds none.\n      if (options.linksMode && _allowMissing) {\n        return undefined;\n      }\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      // @ts-expect-error\n      return adapterFor.call(this, modelName, _allowMissing);\n    }\n\n    serializerFor(this: Store, ...args: Parameters<typeof serializerFor>): ReturnType<typeof serializerFor> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return serializerFor.call(this, ...args);\n    }\n\n    pushPayload(this: Store, ...args: Parameters<typeof pushPayload>): ReturnType<typeof pushPayload> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return pushPayload.call(this, ...args);\n    }\n\n    normalize(this: Store, ...args: Parameters<typeof normalize>): ReturnType<typeof normalize> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return normalize.call(this, ...args);\n    }\n\n    serializeRecord(this: Store, ...args: Parameters<typeof serializeRecord>): ReturnType<typeof serializeRecord> {\n      assert(\n        `useLegacyStore was setup in linksMode. linksMode assumes that all requests have been migrated away from adapters and serializers.`,\n        !options.linksMode\n      );\n      return serializeRecord.call(this, ...args);\n    }\n\n    destroy() {\n      if (!options.linksMode) {\n        cleanup.call(this);\n      }\n      super.destroy();\n    }\n  }\n\n  if (options.legacyRequests) {\n    restoreDeprecatedStoreBehaviors(BaseKlass);\n  }\n\n  return LegacyConfiguredStore;\n}\n\nfunction assertType(schema: DelegatingSchemaService, type: string) {\n  assert(`Expected type ${type} to be a valid ResourceType`, schema.hasResource({ type }));\n}\n"],"mappings":"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"}

package/dist/{json-BXNPTlcH.js → json-n2XHdV_P.js}

@@ -62,6 +62,11 @@ function determineRelationshipType(store, type, knownSide) {
 
 //#endregion
 //#region src/serializer/json.ts
+/**
+* @module
+* @summary Legacy `JSONSerializer`, which normalizes and serializes plain JSON payloads that don't follow the JSON:API
+* spec.
+*/
 const SOURCE_POINTER_REGEXP = /^\/?data\/(attributes|relationships)\/(.*)/;
 const SOURCE_POINTER_PRIMARY_REGEXP = /^\/?data/;
 const PRIMARY_ATTRIBUTE_KEY = "base";
@@ -135,6 +140,8 @@ calls it once. This is the method you most likely want to subclass.
 - `normalize` delegates to these methods to
 turn the record payload into the JSON API format.
 
+@summary Legacy serializer for plain JSON payloads that don't follow the JSON:API spec, normalizing them into
+JSON:API documents for the store.
 @class JSONSerializer
 @public
 */
@@ -1103,4 +1110,4 @@ const JSONSerializer = Serializer.extend({
 
 //#endregion
 export { coerceId as n, inverseForRelationship as r, JSONSerializer as t };
-//# sourceMappingURL=json-BXNPTlcH.js.map
+//# sourceMappingURL=json-n2XHdV_P.js.map

package/dist/json-n2XHdV_P.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-n2XHdV_P.js","names":["coerceId","id","undefined","toString","String","inverseForRelationship","store","type","name","relationship","schema","fields","get","macroCondition","getGlobalConfig","WarpDrive","env","DEBUG","test","Error","options","inverse","length","schemaExists","hasResource","inverseField","kind","determineRelationshipType","knownSide","knownKind","otherKind","getOwner","warn","dasherize","singularize","Serializer","coerceId","determineRelationshipType","macroCondition","getGlobalConfig","SOURCE_POINTER_REGEXP","SOURCE_POINTER_PRIMARY_REGEXP","PRIMARY_ATTRIBUTE_KEY","JSONSerializer","extend","primaryKey","mergedProperties","applyTransforms","typeClass","data","attributes","eachTransformedAttribute","key","type","undefined","transform","transformFor","transformMeta","get","deserialize","options","normalizeResponse","store","primaryModelClass","payload","id","requestType","normalizeFindRecordResponse","arguments","normalizeQueryRecordResponse","normalizeFindAllResponse","normalizeFindBelongsToResponse","normalizeFindHasManyResponse","normalizeFindManyResponse","normalizeQueryResponse","normalizeCreateRecordResponse","normalizeDeleteRecordResponse","normalizeUpdateRecordResponse","normalizeSingleResponse","normalizeArrayResponse","normalizeSaveResponse","_normalizeResponse","isSingle","documentHash","included","meta","extractMeta","WarpDrive","env","DEBUG","test","Error","normalize","ret","Array","length","i","l","item","concat","modelClass","resourceHash","normalizeUsingDeclaredMapping","links","extractId","modelName","extractAttributes","relationships","extractRelationships","lid","attributeKey","eachAttribute","keyForAttribute","extractRelationship","relationshipModelName","relationshipHash","isArray","modelFor","fields","has","modelNameFromPayloadKey","extractPolymorphicRelationship","relationshipOptions","eachRelationship","relationshipMeta","relationship","relationshipKey","keyForRelationship","kind","polymorphic","linkKey","keyForLink","related","normalizeRelationships","hash","payloadKey","attrs","normalizedKey","_getMappedKey","relationshipsByName","mappedKey","_canSerialize","serialize","_mustSerialize","shouldSerializeHasMany","snapshot","relationshipType","json","includeId","attribute","serializeAttribute","serializeBelongsTo","serializeHasMany","serializeIntoHash","Object","assign","value","attr","schema","name","belongsToId","belongsTo","serializePolymorphicType","hasMany","ids","extractErrors","errors","extracted","forEach","error","source","pointer","match","search","push","detail","title","method","attributeType","skipAssertion","lookup"],"sources":["../src/serializer/-private/utils.ts","../src/serializer/json.ts"],"sourcesContent":["import type { Store } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type {\n  LegacyBelongsToField,\n  LegacyHasManyField,\n  LegacyRelationshipField,\n} from '@warp-drive/core/types/schema/fields';\n\ntype Coercable = string | number | boolean | null | undefined | symbol;\n\nexport function coerceId(id: Coercable): string | null {\n  if (id === null || id === undefined || id === '') {\n    return null;\n  } else if (typeof id === 'string') {\n    return id;\n  } else if (typeof id === 'symbol') {\n    return id.toString();\n  } else {\n    return String(id);\n  }\n}\n\n/**\n  Given the name of a relationship on a resource `type`, determines the\n  inverse relationship field (if any) using only the schema service.\n\n  Unlike `Model.inverseFor`, this does not require `type` to be backed by\n  a `Model` class, so it works for both `Model`-based and schema-only\n  (e.g. `withDefaults` migration-support) resources.\n\n  @private\n*/\nexport function inverseForRelationship(store: Store, type: string, name: string): LegacyRelationshipField | null {\n  const relationship = store.schema.fields({ type }).get(name) as LegacyBelongsToField | LegacyHasManyField | undefined;\n  assert(`No relationship named '${name}' on '${type}' exists.`, relationship);\n\n  const { options } = relationship;\n  assert(\n    `Expected the relationship ${name} on ${type} to define an inverse.`,\n    options.inverse === null || (typeof options.inverse === 'string' && options.inverse.length > 0)\n  );\n\n  if (options.inverse === null) {\n    return null;\n  }\n\n  const schemaExists = store.schema.hasResource(relationship);\n  assert(\n    `No associated schema found for '${relationship.type}' while calculating the inverse of ${name} on ${type}`,\n    schemaExists\n  );\n\n  if (!schemaExists) {\n    return null;\n  }\n\n  const inverseField = store.schema.fields(relationship).get(options.inverse);\n  assert(\n    `No inverse relationship found for '${name}' on '${type}'`,\n    inverseField && (inverseField.kind === 'belongsTo' || inverseField.kind === 'hasMany')\n  );\n\n  return inverseField ?? null;\n}\n\n/**\n  Given a relationship field on a resource `type`, determines the\n  cardinality of the relationship using only the schema service.\n\n  Unlike `Model.determineRelationshipType`, this does not require `type`\n  to be backed by a `Model` class, so it works for both `Model`-based and\n  schema-only (e.g. `withDefaults` migration-support) resources.\n\n  @private\n*/\nexport function determineRelationshipType(\n  store: Store,\n  type: string,\n  knownSide: LegacyBelongsToField | LegacyHasManyField\n): 'oneToOne' | 'oneToMany' | 'manyToOne' | 'manyToMany' | 'oneToNone' | 'manyToNone' {\n  const knownKind = knownSide.kind;\n  const inverse = inverseForRelationship(store, type, knownSide.name);\n\n  if (!inverse) {\n    return knownKind === 'belongsTo' ? 'oneToNone' : 'manyToNone';\n  }\n\n  const otherKind = inverse.kind;\n\n  if (otherKind === 'belongsTo') {\n    return knownKind === 'belongsTo' ? 'oneToOne' : 'manyToOne';\n  } else {\n    return knownKind === 'belongsTo' ? 'oneToMany' : 'manyToMany';\n  }\n}\n","/* oxlint-disable typescript/no-unsafe-argument */\n/* oxlint-disable typescript/no-unsafe-call */\n/* oxlint-disable typescript/no-unsafe-return */\n/* oxlint-disable typescript/no-unsafe-member-access */\n/* oxlint-disable typescript/no-unsafe-assignment */\n/**\n * @module\n * @summary Legacy `JSONSerializer`, which normalizes and serializes plain JSON payloads that don't follow the JSON:API\n * spec.\n */\n\nimport { getOwner } from '@ember/application';\nimport { warn } from '@ember/debug';\n\n// oxlint-disable-next-line no-unused-vars\nimport type { RequestManager, Store } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\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 {\n  LegacyAttributeField,\n  LegacyBelongsToField,\n  LegacyHasManyField,\n} from '@warp-drive/core/types/schema/fields';\nimport { dasherize, singularize } from '@warp-drive/utilities/string';\n\nimport type { Snapshot } from '../compat/-private.ts';\nimport { Serializer } from '../serializer.ts';\nimport { coerceId, determineRelationshipType } from './-private/utils.ts';\nimport type { Transform } from './transform.ts';\n\nconst SOURCE_POINTER_REGEXP = /^\\/?data\\/(attributes|relationships)\\/(.*)/;\nconst SOURCE_POINTER_PRIMARY_REGEXP = /^\\/?data/;\nconst PRIMARY_ATTRIBUTE_KEY = 'base';\n\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 adapter, consider writing a\n    {@link Handler} instead to be used with the {@link RequestManager}\n  :::\n\n  In WarpDrive a Serializer is used to serialize and deserialize\n  records when they are transferred in and out of an external source.\n  This process involves normalizing property names, transforming\n  attribute values and serializing relationships.\n\n  By default, WarpDrive uses and recommends the `JSONAPISerializer`.\n\n  `JSONSerializer` is useful for simpler or legacy backends that may\n  not support the http://jsonapi.org/ spec.\n\n  For example, given the following `User` model and JSON payload:\n\n  ```js [app/models/user.js]\n  import Model, { attr, belongsTo, hasMany } from '@warp-drive/legacy/model';\n\n  export default class UserModel extends Model {\n    @hasMany('user') friends;\n    @belongsTo('location') house;\n\n    @attr('string') name;\n  }\n  ```\n\n  ```js\n  {\n    id: 1,\n    name: 'Sebastian',\n    friends: [3, 4],\n    links: {\n      house: '/houses/lefkada'\n    }\n  }\n  ```\n\n  `JSONSerializer` will normalize the JSON payload to the {json:api} format that the\n  JSONAPICache uses to cache data in the Store.\n\n  You can customize how JSONSerializer processes its payload by passing options in\n  the `attrs` hash or by subclassing the `JSONSerializer` and overriding hooks:\n\n    - To customize how a single record is normalized, use the `normalize` hook.\n    - To customize how `JSONSerializer` normalizes the whole server response, use the\n      `normalizeResponse` hook.\n    - To customize how `JSONSerializer` normalizes a specific response from the server,\n      use one of the many specific `normalizeResponse` hooks.\n    - To customize how `JSONSerializer` normalizes your id, attributes or relationships,\n      use the `extractId`, `extractAttributes` and `extractRelationships` hooks.\n\n  The `JSONSerializer` normalization process follows these steps:\n\n    1. `normalizeResponse`\n        - entry method to the serializer.\n    2. `normalizeCreateRecordResponse`\n        - a `normalizeResponse` for a specific operation is called.\n    3. `normalizeSingleResponse`|`normalizeArrayResponse`\n        - for methods like `createRecord` we expect a single record back, while for methods like `findAll` we expect multiple records back.\n    4. `normalize`\n        - `normalizeArrayResponse` iterates and calls `normalize` for each of its records while `normalizeSingle`\n          calls it once. This is the method you most likely want to subclass.\n    5. `extractId` | `extractAttributes` | `extractRelationships`\n        - `normalize` delegates to these methods to\n          turn the record payload into the JSON API format.\n\n  @summary Legacy serializer for plain JSON payloads that don't follow the JSON:API spec, normalizing them into\n  JSON:API documents for the store.\n  @class JSONSerializer\n  @public\n*/\n// oxlint-disable-next-line typescript/no-explicit-any\nconst JSONSerializer: any = Serializer.extend({\n  /**\n    The `primaryKey` is used when serializing and deserializing\n    data. WarpDrive always uses the `id` property to store the id of\n    the record. The external source may not always follow this\n    convention. In these cases it is useful to override the\n    `primaryKey` property to match the `primaryKey` of your external\n    store.\n\n    Example\n\n    ```js [app/serializers/application.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class ApplicationSerializer extends JSONSerializer {\n      primaryKey = '_id'\n    }\n    ```\n\n    @public\n    @default 'id'\n  */\n  primaryKey: 'id',\n\n  /**\n    The `attrs` object can be used to declare a simple mapping between\n    property names on `Model` records and payload keys in the\n    serialized JSON object representing the record. An object with the\n    property `key` can also be used to designate the attribute's key on\n    the response payload.\n\n    Example\n\n    ```js [app/models/person.js]\n    import Model, { attr } from '@warp-drive/legacy/model';\n\n    export default class PersonModel extends Model {\n      @attr('string') firstName;\n      @attr('string') lastName;\n      @attr('string') occupation;\n      @attr('boolean') admin;\n    }\n    ```\n\n    ```js [app/serializers/person.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PersonSerializer extends JSONSerializer {\n      attrs = {\n        admin: 'is_admin',\n        occupation: { key: 'career' }\n      }\n    }\n    ```\n\n    You can also remove attributes and relationships by setting the `serialize`\n    key to `false` in your mapping object.\n\n    Example\n\n    ```js [app/serializers/person.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PostSerializer extends JSONSerializer {\n      attrs = {\n        admin: { serialize: false },\n        occupation: { key: 'career' }\n      }\n    }\n    ```\n\n    When serialized:\n\n    ```js\n    {\n      \"firstName\": \"Harry\",\n      \"lastName\": \"Houdini\",\n      \"career\": \"magician\"\n    }\n    ```\n\n    Note that the `admin` is now not included in the payload.\n\n    Setting `serialize` to `true` enforces serialization for hasMany\n    relationships even if it's neither a many-to-many nor many-to-none\n    relationship.\n\n    @public\n  */\n  mergedProperties: ['attrs'],\n\n  /**\n   Given a subclass of `Model` and a JSON object this method will\n   iterate through each attribute of the `Model` and invoke the\n   `Transform#deserialize` method on the matching property of the\n   JSON object.  This method is typically called after the\n   serializer's `normalize` method.\n\n   @private\n  */\n  applyTransforms(typeClass: ModelSchema, data: object): object {\n    const attributes = typeClass.attributes;\n\n    typeClass.eachTransformedAttribute((key, type) => {\n      if (data[key] === undefined) {\n        return;\n      }\n\n      const transform = this.transformFor(type!);\n      const transformMeta = attributes.get(key);\n      data[key] = transform.deserialize(data[key], transformMeta!.options);\n    });\n\n    return data;\n  },\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    This method delegates to a more specific normalize method based on\n    the `requestType`.\n\n    To override this method with a custom one, make sure to call\n    `return super.normalizeResponse(store, primaryModelClass, payload, id, requestType)` with your\n    pre-processed data.\n\n    Here's an example of using `normalizeResponse` manually:\n\n    ```javascript\n    socket.on('message', function(message) {\n      let data = message.data;\n      let modelClass = store.modelFor(data.modelName);\n      let serializer = store.serializerFor(data.modelName);\n      let normalized = serializer.normalizeSingleResponse(store, modelClass, data, data.id);\n\n      store.push(normalized);\n    });\n    ```\n\n    @since 1.13.0\n    @public\n  */\n  normalizeResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: string | null,\n    requestType: string\n    // @ts-expect-error\n  ): object {\n    switch (requestType) {\n      case 'findRecord':\n        // @ts-expect-error\n        return this.normalizeFindRecordResponse(...arguments);\n      case 'queryRecord':\n        // @ts-expect-error\n        return this.normalizeQueryRecordResponse(...arguments);\n      case 'findAll':\n        // @ts-expect-error\n        return this.normalizeFindAllResponse(...arguments);\n      case 'findBelongsTo':\n        // @ts-expect-error\n        return this.normalizeFindBelongsToResponse(...arguments);\n      case 'findHasMany':\n        // @ts-expect-error\n        return this.normalizeFindHasManyResponse(...arguments);\n      case 'findMany':\n        // @ts-expect-error\n        return this.normalizeFindManyResponse(...arguments);\n      case 'query':\n        // @ts-expect-error\n        return this.normalizeQueryResponse(...arguments);\n      case 'createRecord':\n        // @ts-expect-error\n        return this.normalizeCreateRecordResponse(...arguments);\n      case 'deleteRecord':\n        // @ts-expect-error\n        return this.normalizeDeleteRecordResponse(...arguments);\n      case 'updateRecord':\n        // @ts-expect-error\n        return this.normalizeUpdateRecordResponse(...arguments);\n    }\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `findRecord`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeFindRecordResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: string,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSingleResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `queryRecord`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeQueryRecordResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSingleResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `findAll`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeFindAllResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeArrayResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `findBelongsTo`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeFindBelongsToResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSingleResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `findHasMany`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeFindHasManyResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeArrayResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `findMany`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeFindManyResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeArrayResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `query`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeQueryResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeArrayResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `createRecord`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeCreateRecordResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: unknown,\n    id: string,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSaveResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `deleteRecord`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeDeleteRecordResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: object,\n    id: string | null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSaveResponse(...arguments);\n  },\n\n  /**\n    Called by the default normalizeResponse implementation when the\n    type of request is `updateRecord`\n\n    @since 1.13.0\n    @public\n  */\n  normalizeUpdateRecordResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: object,\n    id: string | null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSaveResponse(...arguments);\n  },\n\n  /**\n    normalizeUpdateRecordResponse, normalizeCreateRecordResponse and\n    normalizeDeleteRecordResponse delegate to this method by default.\n\n    @since 1.13.0\n    @public\n  */\n  normalizeSaveResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: object,\n    id: string | null,\n    requestType: string\n  ): object {\n    // @ts-expect-error\n    return this.normalizeSingleResponse(...arguments);\n  },\n\n  /**\n    normalizeQueryResponse and normalizeFindRecordResponse delegate to this\n    method by default.\n\n    @since 1.13.0\n    @public\n  */\n  normalizeSingleResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: object,\n    id: string | null,\n    requestType: string\n  ): object {\n    return this._normalizeResponse(store, primaryModelClass, payload, id, requestType, true);\n  },\n\n  /**\n    normalizeQueryResponse, normalizeFindManyResponse, and normalizeFindHasManyResponse delegate\n    to this method by default.\n\n    @since 1.13.0\n    @public\n  */\n  normalizeArrayResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: object,\n    id: string | null,\n    requestType: string\n  ): object {\n    return this._normalizeResponse(store, primaryModelClass, payload, id, requestType, false);\n  },\n\n  /**\n    @private\n  */\n  _normalizeResponse(\n    store: Store,\n    primaryModelClass: ModelSchema,\n    payload: object,\n    id: string | null,\n    requestType: string,\n    isSingle: boolean\n  ): object {\n    const documentHash = {\n      data: null,\n      included: [],\n    };\n\n    const meta = this.extractMeta(store, primaryModelClass, payload);\n    if (meta) {\n      assert(\n        'The `meta` returned from `extractMeta` has to be an object, not \"' + typeof meta + '\".',\n        typeof meta === 'object'\n      );\n      // @ts-expect-error untyped\n      documentHash.meta = meta;\n    }\n\n    if (isSingle) {\n      // @ts-expect-error untyped\n      const { data, included } = this.normalize(primaryModelClass, payload);\n      documentHash.data = data;\n      if (included) {\n        documentHash.included = included;\n      }\n    } else {\n      // @ts-expect-error untyped\n      const ret = new Array(payload.length);\n      // @ts-expect-error untyped\n      for (let i = 0, l = payload.length; i < l; i++) {\n        const item = payload[i];\n        // @ts-expect-error untyped\n        const { data, included } = this.normalize(primaryModelClass, item);\n        if (included) {\n          documentHash.included = documentHash.included.concat(included);\n        }\n        ret[i] = data;\n      }\n\n      // @ts-expect-error untyped\n      documentHash.data = ret;\n    }\n\n    return documentHash;\n  },\n\n  /**\n    Normalizes a part of the JSON payload returned by\n    the server. You should override this method, munge the hash\n    and call super if you have generic normalization to do.\n\n    It takes the type of the record that is being normalized\n    (as a Model class), the property where the hash was\n    originally found, and the hash to normalize.\n\n    You can use this method, for example, to normalize underscored keys to camelized\n    or other general-purpose normalizations.\n\n    Example\n\n    ```js [app/serializers/application.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n    import { underscore } from '<app-name>/utils/string-utils';\n    import { get } from '@ember/object';\n\n    export default class ApplicationSerializer extends JSONSerializer {\n      normalize(typeClass, hash) {\n        let fields = typeClass.fields;\n\n        fields.forEach(function(type, field) {\n          let payloadField = underscore(field);\n          if (field === payloadField) { return; }\n\n          hash[field] = hash[payloadField];\n          delete hash[payloadField];\n        });\n\n        return super.normalize(...arguments);\n      }\n    }\n    ```\n\n    @public\n  */\n  normalize(modelClass: ModelSchema, resourceHash: object): object {\n    let data = null;\n\n    if (resourceHash) {\n      this.normalizeUsingDeclaredMapping(modelClass, resourceHash);\n      // @ts-expect-error untyped\n      if (typeof resourceHash.links === 'object') {\n        // @ts-expect-error untyped\n        this.normalizeUsingDeclaredMapping(modelClass, resourceHash.links);\n      }\n\n      // @ts-expect-error untyped\n      data = {\n        id: this.extractId(modelClass, resourceHash),\n        type: modelClass.modelName,\n        attributes: this.extractAttributes(modelClass, resourceHash),\n        relationships: this.extractRelationships(modelClass, resourceHash),\n      };\n\n      // @ts-expect-error untyped\n      if (resourceHash.lid) {\n        // @ts-expect-error untyped\n        data.lid = resourceHash.lid;\n      }\n\n      // @ts-expect-error untyped\n      this.applyTransforms(modelClass, data.attributes);\n    }\n\n    return { data };\n  },\n\n  /**\n    Returns the resource's ID.\n\n    @public\n  */\n  extractId(modelClass: ModelSchema, resourceHash: object): string {\n    const primaryKey = this.primaryKey;\n    const id = resourceHash[primaryKey];\n    return coerceId(id) as string;\n  },\n\n  /**\n    Returns the resource's attributes formatted as a JSON-API \"attributes object\".\n\n    http://jsonapi.org/format/#document-resource-object-attributes\n\n    @public\n  */\n  extractAttributes(modelClass: ModelSchema, resourceHash: object): object {\n    let attributeKey;\n    const attributes = {};\n\n    modelClass.eachAttribute((key) => {\n      attributeKey = this.keyForAttribute(key, 'deserialize');\n      if (resourceHash[attributeKey] !== undefined) {\n        attributes[key] = resourceHash[attributeKey];\n      }\n    });\n\n    return attributes;\n  },\n\n  /**\n    Returns a relationship formatted as a JSON-API \"relationship object\".\n\n    http://jsonapi.org/format/#document-resource-object-relationships\n\n    @public\n  */\n  extractRelationship(relationshipModelName: string, relationshipHash: object): object | null {\n    if (!relationshipHash) {\n      return null;\n    }\n    /*\n      When `relationshipHash` is an object it usually means that the relationship\n      is polymorphic. It could however also be embedded resources that the\n      EmbeddedRecordsMixin has be able to process.\n    */\n    if (relationshipHash && typeof relationshipHash === 'object' && !Array.isArray(relationshipHash)) {\n      // @ts-expect-error untyped\n      if (relationshipHash.id) {\n        // @ts-expect-error untyped\n        relationshipHash.id = coerceId(relationshipHash.id);\n      }\n\n      // @ts-expect-error store is dynamically injected\n      const modelClass = this.store.modelFor(relationshipModelName);\n      // @ts-expect-error untyped\n      if (relationshipHash.type && !modelClass.fields.has('type')) {\n        // @ts-expect-error untyped\n        relationshipHash.type = this.modelNameFromPayloadKey(relationshipHash.type);\n      }\n\n      return relationshipHash;\n    }\n    return {\n      id: coerceId(relationshipHash as unknown as string | number | null),\n      type: dasherize(singularize(relationshipModelName)),\n    };\n  },\n\n  /**\n    Returns a polymorphic relationship formatted as a JSON-API \"relationship object\".\n\n    http://jsonapi.org/format/#document-resource-object-relationships\n\n    `relationshipOptions` is a hash which contains more information about the\n    polymorphic relationship which should be extracted:\n      - `resourceHash` complete hash of the resource the relationship should be\n        extracted from\n      - `relationshipKey` key under which the value for the relationship is\n        extracted from the resourceHash\n      - `relationshipMeta` meta information about the relationship\n\n    @public\n  */\n  extractPolymorphicRelationship(\n    relationshipModelName: string,\n    relationshipHash: object,\n    relationshipOptions?: object\n  ): object | null {\n    return this.extractRelationship(relationshipModelName, relationshipHash);\n  },\n\n  /**\n    Returns the resource's relationships formatted as a JSON-API \"relationships object\".\n\n    http://jsonapi.org/format/#document-resource-object-relationships\n\n    @public\n  */\n  extractRelationships(modelClass: ModelSchema, resourceHash: object): object {\n    const relationships = {};\n\n    modelClass.eachRelationship((key, relationshipMeta) => {\n      let relationship = null;\n      const relationshipKey = this.keyForRelationship(key, relationshipMeta.kind, 'deserialize');\n      if (resourceHash[relationshipKey] !== undefined) {\n        let data = null;\n        const relationshipHash = resourceHash[relationshipKey];\n        if (relationshipMeta.kind === 'belongsTo') {\n          if (relationshipMeta.options.polymorphic) {\n            // extracting a polymorphic belongsTo may need more information\n            // than the type and the hash (which might only be an id) for the\n            // relationship, hence we pass the key, resource and\n            // relationshipMeta too\n            // @ts-expect-error untyped\n            data = this.extractPolymorphicRelationship(relationshipMeta.type, relationshipHash, {\n              key,\n              resourceHash,\n              relationshipMeta,\n            });\n          } else {\n            // @ts-expect-error untyped\n            data = this.extractRelationship(relationshipMeta.type, relationshipHash);\n          }\n        } else if (relationshipMeta.kind === 'hasMany') {\n          if (relationshipHash) {\n            // @ts-expect-error untyped\n            data = new Array(relationshipHash.length);\n            if (relationshipMeta.options.polymorphic) {\n              for (let i = 0, l = relationshipHash.length; i < l; i++) {\n                const item = relationshipHash[i];\n                // @ts-expect-error untyped\n                data[i] = this.extractPolymorphicRelationship(relationshipMeta.type, item, {\n                  key,\n                  resourceHash,\n                  relationshipMeta,\n                });\n              }\n            } else {\n              for (let i = 0, l = relationshipHash.length; i < l; i++) {\n                const item = relationshipHash[i];\n                // @ts-expect-error untyped\n                data[i] = this.extractRelationship(relationshipMeta.type, item);\n              }\n            }\n          }\n        }\n        // @ts-expect-error untyped\n        relationship = { data };\n      }\n\n      const linkKey = this.keyForLink(key, relationshipMeta.kind);\n      // @ts-expect-error untyped\n      if (resourceHash.links && resourceHash.links[linkKey] !== undefined) {\n        // @ts-expect-error untyped\n        const related = resourceHash.links[linkKey];\n        // @ts-expect-error untyped\n        relationship = relationship || {};\n        // @ts-expect-error untyped\n        relationship.links = { related };\n      }\n\n      if (relationship) {\n        relationships[key] = relationship;\n      }\n    });\n\n    return relationships;\n  },\n\n  /**\n    Dasherizes the model name in the payload\n\n    @public\n    @return the model's modelName\n  */\n  modelNameFromPayloadKey(key: string): string {\n    return dasherize(singularize(key));\n  },\n\n  /**\n    @private\n  */\n  normalizeRelationships(typeClass: ModelSchema, hash: object): void {\n    let payloadKey;\n\n    if (this.keyForRelationship) {\n      typeClass.eachRelationship((key, relationship) => {\n        payloadKey = this.keyForRelationship(key, relationship.kind, 'deserialize');\n        if (key === payloadKey) {\n          return;\n        }\n        if (hash[payloadKey] === undefined) {\n          return;\n        }\n\n        hash[key] = hash[payloadKey];\n        delete hash[payloadKey];\n      });\n    }\n  },\n\n  /**\n    @private\n  */\n  normalizeUsingDeclaredMapping(modelClass: ModelSchema, hash: object): void {\n    // @ts-expect-error attrs is dynamically injected\n    const attrs = this.attrs;\n    let normalizedKey;\n    let payloadKey;\n\n    if (attrs) {\n      for (const key in attrs) {\n        normalizedKey = payloadKey = this._getMappedKey(key, modelClass);\n\n        if (hash[payloadKey] === undefined) {\n          continue;\n        }\n\n        if (modelClass.attributes.has(key)) {\n          normalizedKey = this.keyForAttribute(key, 'deserialize');\n        }\n\n        if (modelClass.relationshipsByName.has(key)) {\n          normalizedKey = this.keyForRelationship(key, modelClass, 'deserialize');\n        }\n\n        if (payloadKey !== normalizedKey) {\n          hash[normalizedKey] = hash[payloadKey];\n          delete hash[payloadKey];\n        }\n      }\n    }\n  },\n\n  /**\n    Looks up the property key that was set by the custom `attr` mapping\n    passed to the serializer.\n\n    @private\n  */\n  _getMappedKey(key: string, modelClass: ModelSchema): string {\n    warn(\n      'There is no attribute or relationship with the name `' +\n        key +\n        '` on `' +\n        modelClass.modelName +\n        '`. Check your serializers attrs hash.',\n      modelClass.attributes.has(key) || modelClass.relationshipsByName.has(key),\n      {\n        id: 'ds.serializer.no-mapped-attrs-key',\n      }\n    );\n    // @ts-expect-error attrs is dynamically injected\n    const attrs = this.attrs;\n    let mappedKey;\n    if (attrs && attrs[key]) {\n      mappedKey = attrs[key];\n      //We need to account for both the { title: 'post_title' } and\n      //{ title: { key: 'post_title' }} forms\n      if (mappedKey.key) {\n        mappedKey = mappedKey.key;\n      }\n      if (typeof mappedKey === 'string') {\n        key = mappedKey;\n      }\n    }\n\n    return key;\n  },\n\n  /**\n    Check attrs.key.serialize property to inform if the `key`\n    can be serialized\n\n    @private\n    @return true if the key can be serialized\n  */\n  _canSerialize(key: string): boolean {\n    // @ts-expect-error no idea what attrs is here\n    const attrs = this.attrs;\n\n    return !attrs || !attrs[key] || attrs[key].serialize !== false;\n  },\n\n  /**\n    When attrs.key.serialize is set to true then\n    it takes priority over the other checks and the related\n    attribute/relationship will be serialized\n\n    @private\n    @return true if the key must be serialized\n  */\n  _mustSerialize(key: string): boolean {\n    // @ts-expect-error no idea what attrs is here\n    const attrs = this.attrs;\n\n    return attrs && attrs[key] && attrs[key].serialize === true;\n  },\n\n  /**\n    Check if the given hasMany relationship should be serialized\n\n    By default only many-to-many and many-to-none relationships are serialized.\n    This could be configured per relationship by Serializer's `attrs` object.\n\n    @public\n    @return true if the hasMany relationship should be serialized\n  */\n  shouldSerializeHasMany(\n    snapshot: Snapshot,\n    key: string,\n    relationship: LegacyBelongsToField | LegacyHasManyField\n  ): boolean {\n    // @ts-expect-error store is dynamically injected\n    const relationshipType = determineRelationshipType(this.store, snapshot.modelName, relationship);\n    if (this._mustSerialize(key)) {\n      return true;\n    }\n    return this._canSerialize(key) && (relationshipType === 'manyToNone' || relationshipType === 'manyToMany');\n  },\n\n  // SERIALIZE\n  /**\n    Called when a record is saved in order to convert the\n    record into JSON.\n\n    By default, it creates a JSON object with a key for\n    each attribute and belongsTo relationship.\n\n    For example, consider this model:\n\n    ```js [app/models/comment.js]\n    import Model, { attr, belongsTo } from '@warp-drive/legacy/model';\n\n    export default class CommentModel extends Model {\n      @attr title;\n      @attr body;\n\n      @belongsTo('user') author;\n    }\n    ```\n\n    The default serialization would create a JSON object like:\n\n    ```javascript\n    {\n      \"title\": \"Rails is unagi\",\n      \"body\": \"Rails? Omakase? O_O\",\n      \"author\": 12\n    }\n    ```\n\n    By default, attributes are passed through as-is, unless\n    you specified an attribute type (`attr('date')`). If\n    you specify a transform, the JavaScript value will be\n    serialized when inserted into the JSON hash.\n\n    By default, belongs-to relationships are converted into\n    IDs when inserted into the JSON hash.\n\n    ## IDs\n\n    `serialize` takes an options hash with a single option:\n    `includeId`. If this option is `true`, `serialize` will,\n    by default include the ID in the JSON object it builds.\n\n    Whether `includeId` is `true` or `false` depends on the\n    adapter and the operation being performed, since it is the\n    adapter that invokes `serialize` and decides which options\n    to pass. For instance, `RESTAdapter` passes `includeId: true`\n    when serializing a record for `createRecord`, but not for\n    `updateRecord`, while `JSONAPIAdapter` passes `includeId: true`\n    for both `createRecord` and `updateRecord`. Refer to the\n    documentation for the adapter and serializer pairing you are\n    using for specifics.\n\n    ## Customization\n\n    Your server may expect a different JSON format than the\n    built-in serialization format.\n\n    In that case, you can implement `serialize` yourself and\n    return a JSON hash of your choosing.\n\n    ```js [app/serializers/post.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PostSerializer extends JSONSerializer {\n      serialize(snapshot, options) {\n        let json = {\n          POST_TTL: snapshot.attr('title'),\n          POST_BDY: snapshot.attr('body'),\n          POST_CMS: snapshot.hasMany('comments', { ids: true })\n        };\n\n        if (options.includeId) {\n          json.POST_ID_ = snapshot.id;\n        }\n\n        return json;\n      }\n    }\n    ```\n\n    ## Customizing an App-Wide Serializer\n\n    If you want to define a serializer for your entire\n    application, you'll probably want to use `eachAttribute`\n    and `eachRelationship` on the record.\n\n    ```js [app/serializers/application.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n    import { singularize } from '<app-name>/utils/string-utils';\n\n    export default class ApplicationSerializer extends JSONSerializer {\n      serialize(snapshot, options) {\n        let json = {};\n\n        snapshot.eachAttribute((name) => {\n          json[serverAttributeName(name)] = snapshot.attr(name);\n        });\n\n        snapshot.eachRelationship((name, relationship) => {\n          if (relationship.kind === 'hasMany') {\n            json[serverHasManyName(name)] = snapshot.hasMany(name, { ids: true });\n          }\n        });\n\n        if (options.includeId) {\n          json.ID_ = snapshot.id;\n        }\n\n        return json;\n      }\n    }\n\n    function serverAttributeName(attribute) {\n      return attribute.underscore().toUpperCase();\n    }\n\n    function serverHasManyName(name) {\n      return serverAttributeName(singularize(name)) + \"_IDS\";\n    }\n    ```\n\n    This serializer will generate JSON that looks like this:\n\n    ```javascript\n    {\n      \"TITLE\": \"Rails is omakase\",\n      \"BODY\": \"Yep. Omakase.\",\n      \"COMMENT_IDS\": [ \"1\", \"2\", \"3\" ]\n    }\n    ```\n\n    ## Tweaking the Default JSON\n\n    If you just want to do some small tweaks on the default JSON,\n    you can call `super.serialize` first and make the tweaks on\n    the returned JSON.\n\n    ```js [app/serializers/post.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PostSerializer extends JSONSerializer {\n      serialize(snapshot, options) {\n        let json = super.serialize(...arguments);\n\n        json.subject = json.title;\n        delete json.title;\n\n        return json;\n      }\n    }\n    ```\n\n    @public\n  */\n  serialize(snapshot: Snapshot, options: object): object {\n    const json = {};\n\n    // @ts-expect-error super loose typing here right now\n    if (options && options.includeId) {\n      const id = snapshot.id;\n      if (id) {\n        json[this.primaryKey] = id;\n      }\n    }\n\n    snapshot.eachAttribute((key, attribute) => {\n      this.serializeAttribute(snapshot, json, key, attribute);\n    });\n\n    snapshot.eachRelationship((key, relationship) => {\n      if (relationship.kind === 'belongsTo') {\n        this.serializeBelongsTo(snapshot, json, relationship);\n      } else if (relationship.kind === 'hasMany') {\n        this.serializeHasMany(snapshot, json, relationship);\n      }\n    });\n\n    return json;\n  },\n\n  /**\n    You can use this method to customize how a serialized record is added to the complete\n    JSON hash to be sent to the server. By default the JSON Serializer does not namespace\n    the payload and just sends the raw serialized JSON object.\n    If your server expects namespaced keys, you should consider using the RESTSerializer.\n    Otherwise you can override this method to customize how the record is added to the hash.\n    The hash property should be modified by reference.\n\n    For example, your server may expect underscored root objects.\n\n    ```js [app/serializers/application.js]\n    import RESTSerializer from '@warp-drive/legacy/serializer/rest';\n    import { underscoren} from '<app-name>/utils/string-utils';\n\n    export default class ApplicationSerializer extends RESTSerializer {\n      serializeIntoHash(data, type, snapshot, options) {\n        let root = underscore(type.modelName);\n        data[root] = this.serialize(snapshot, options);\n      }\n    }\n    ```\n\n    @public\n  */\n  serializeIntoHash(hash: object, typeClass: ModelSchema, snapshot: Snapshot, options: object): void {\n    Object.assign(hash, this.serialize(snapshot, options));\n  },\n\n  /**\n    `serializeAttribute` can be used to customize how `attr`\n    properties are serialized\n\n    For example if you wanted to ensure all your attributes were always\n    serialized as properties on an `attributes` object you could\n    write:\n\n    ```js [app/serializers/application.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class ApplicationSerializer extends JSONSerializer {\n      serializeAttribute(snapshot, json, key, attributes) {\n        json.attributes = json.attributes || {};\n        super.serializeAttribute(snapshot, json.attributes, key, attributes);\n      }\n    }\n    ```\n\n    @public\n  */\n  serializeAttribute(snapshot: Snapshot, json: object, key: string, attribute: LegacyAttributeField): void {\n    if (this._canSerialize(key)) {\n      const type = attribute.type;\n      // @ts-expect-error we don't know what is on the snapshot\n      let value = snapshot.attr(key);\n      if (type) {\n        const transform = this.transformFor(type);\n        value = transform.serialize(value, attribute.options);\n      }\n\n      // if provided, use the mapping provided by `attrs` in\n      // the serializer\n      // @ts-expect-error store added dynamically\n      const schema = this.store.modelFor(snapshot.modelName);\n      let payloadKey = this._getMappedKey(key, schema);\n\n      if (payloadKey === key && this.keyForAttribute) {\n        payloadKey = this.keyForAttribute(key, 'serialize');\n      }\n\n      json[payloadKey] = value;\n    }\n  },\n\n  /**\n    `serializeBelongsTo` can be used to customize how `belongsTo`\n    properties are serialized.\n\n    Example\n\n    ```js [app/serializers/post.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PostSerializer extends JSONSerializer {\n      serializeBelongsTo(snapshot, json, relationship) {\n        let key = relationship.name;\n        let belongsTo = snapshot.belongsTo(key);\n\n        key = this.keyForRelationship ? this.keyForRelationship(key, \"belongsTo\", \"serialize\") : key;\n\n        json[key] = !belongsTo ? null : belongsTo.record.toJSON();\n      }\n    }\n    ```\n\n    @public\n  */\n  serializeBelongsTo(snapshot: Snapshot, json: object, relationship: LegacyHasManyField | LegacyBelongsToField): void {\n    const name = relationship.name;\n\n    if (this._canSerialize(name)) {\n      const belongsToId = snapshot.belongsTo(name, { id: true });\n\n      // if provided, use the mapping provided by `attrs` in\n      // the serializer\n      // @ts-expect-error store added dynamically\n      const schema = this.store.modelFor(snapshot.modelName);\n      let payloadKey = this._getMappedKey(name, schema);\n      if (payloadKey === name && this.keyForRelationship) {\n        payloadKey = this.keyForRelationship(name, 'belongsTo', 'serialize');\n      }\n\n      //Need to check whether the id is there for new&async records\n      if (!belongsToId) {\n        json[payloadKey] = null;\n      } else {\n        json[payloadKey] = belongsToId;\n      }\n\n      if (relationship.options.polymorphic) {\n        this.serializePolymorphicType(snapshot, json, relationship);\n      }\n    }\n  },\n\n  /**\n   `serializeHasMany` can be used to customize how `hasMany`\n   properties are serialized.\n\n   Example\n\n   ```js [app/serializers/post.js]\n   import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n   export default class PostSerializer extends JSONSerializer {\n     serializeHasMany(snapshot, json, relationship) {\n       let key = relationship.name;\n       if (key === 'comments') {\n         return;\n       } else {\n         super.serializeHasMany(...arguments);\n       }\n     }\n   }\n   ```\n\n    @public\n  */\n  serializeHasMany(snapshot: Snapshot, json: object, relationship: LegacyBelongsToField | LegacyHasManyField): void {\n    const name = relationship.name;\n\n    if (this.shouldSerializeHasMany(snapshot, name, relationship)) {\n      const hasMany = snapshot.hasMany(name, { ids: true });\n      if (hasMany !== undefined) {\n        // if provided, use the mapping provided by `attrs` in\n        // the serializer\n        // @ts-expect-error store added dynamically\n        const schema = this.store.modelFor(snapshot.modelName);\n        let payloadKey = this._getMappedKey(name, schema);\n        if (payloadKey === name && this.keyForRelationship) {\n          payloadKey = this.keyForRelationship(name, 'hasMany', 'serialize');\n        }\n\n        json[payloadKey] = hasMany;\n        // TODO support for polymorphic manyToNone and manyToMany relationships\n      }\n    }\n  },\n\n  /**\n    You can use this method to customize how polymorphic objects are\n    serialized. Objects are considered to be polymorphic if\n    `{ polymorphic: true }` is pass as the second argument to the\n    `belongsTo` function.\n\n    Example\n\n    ```js [app/serializers/comment.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class CommentSerializer extends JSONSerializer {\n      serializePolymorphicType(snapshot, json, relationship) {\n        let key = relationship.name;\n        let belongsTo = snapshot.belongsTo(key);\n\n        key = this.keyForAttribute ? this.keyForAttribute(key, 'serialize') : key;\n\n        if (!belongsTo) {\n          json[key + '_type'] = null;\n        } else {\n          json[key + '_type'] = belongsTo.modelName;\n        }\n      }\n    }\n    ```\n\n    @public\n  */\n  serializePolymorphicType(\n    snapshot: Snapshot,\n    json: object,\n    relationship: LegacyBelongsToField | LegacyHasManyField\n  ): void {},\n\n  /**\n    `extractMeta` is used to deserialize any meta information in the\n    adapter payload. By default Ember Data expects meta information to\n    be located on the `meta` property of the payload object.\n\n    Example\n\n    ```js [app/serializers/post.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PostSerializer extends JSONSerializer {\n      extractMeta(store, typeClass, payload) {\n        if (payload && payload.hasOwnProperty('_pagination')) {\n          let meta = payload._pagination;\n          delete payload._pagination;\n          return meta;\n        }\n      }\n    }\n    ```\n\n    @public\n  */\n  extractMeta(store: Store, modelClass: ModelSchema, payload: object): object | undefined {\n    if (payload && payload['meta'] !== undefined) {\n      // @ts-expect-error\n      const meta = payload.meta;\n      // @ts-expect-error\n      delete payload.meta;\n      return meta;\n    }\n  },\n\n  /**\n    `extractErrors` is used to extract model errors when a call\n    to `Model#save` fails with an `InvalidError`. By default\n    Ember Data expects error information to be located on the `errors`\n    property of the payload object.\n\n    This serializer expects this `errors` object to be an Array similar\n    to the following, compliant with the https://jsonapi.org/format/#errors specification:\n\n    ```js\n    {\n      \"errors\": [\n        {\n          \"detail\": \"This username is already taken!\",\n          \"source\": {\n            \"pointer\": \"data/attributes/username\"\n          }\n        }, {\n          \"detail\": \"Doesn't look like a valid email.\",\n          \"source\": {\n            \"pointer\": \"data/attributes/email\"\n          }\n        }\n      ]\n    }\n    ```\n\n    The key `detail` provides a textual description of the problem.\n    Alternatively, the key `title` can be used for the same purpose.\n\n    The nested keys `source.pointer` detail which specific element\n    of the request data was invalid.\n\n    Note that JSON-API also allows for object-level errors to be placed\n    in an object with pointer `data`, signifying that the problem\n    cannot be traced to a specific attribute:\n\n    ```javascript\n    {\n      \"errors\": [\n        {\n          \"detail\": \"Some generic non property error message\",\n          \"source\": {\n            \"pointer\": \"data\"\n          }\n        }\n      ]\n    }\n    ```\n\n    When turn into a `Errors` object, you can read these errors\n    through the property `base`:\n\n    ```handlebars\n    {{#each @model.errors.base as |error|}}\n      <div class=\"error\">\n        {{error.message}}\n      </div>\n    {{/each}}\n    ```\n\n    Example of alternative implementation, overriding the default\n    behavior to deal with a different format of errors:\n\n    ```js [app/serializers/post.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n\n    export default class PostSerializer extends JSONSerializer {\n      extractErrors(store, typeClass, payload, id) {\n        if (payload && typeof payload === 'object' && payload._problems) {\n          payload = payload._problems;\n          this.normalizeErrors(typeClass, payload);\n        }\n        return payload;\n      }\n    }\n    ```\n\n    @public\n    @return json The deserialized errors\n  */\n  extractErrors(store: Store, typeClass: ModelSchema, payload: object, id: string | null): object {\n    // @ts-expect-error\n    if (payload && typeof payload === 'object' && payload.errors) {\n      // the default assumption is that errors is already in JSON:API format\n      const extracted = {};\n\n      // @ts-expect-error\n      payload.errors.forEach((error) => {\n        if (error.source && error.source.pointer) {\n          let key = error.source.pointer.match(SOURCE_POINTER_REGEXP);\n\n          if (key) {\n            key = key[2];\n          } else if (error.source.pointer.search(SOURCE_POINTER_PRIMARY_REGEXP) !== -1) {\n            key = PRIMARY_ATTRIBUTE_KEY;\n          }\n\n          if (key) {\n            extracted[key] = extracted[key] || [];\n            extracted[key].push(error.detail || error.title);\n          }\n        }\n      });\n\n      // if the user has an attrs hash, convert keys using it\n      this.normalizeUsingDeclaredMapping(typeClass, extracted);\n\n      // for each attr and relationship, make sure that we use\n      // the normalized key\n      typeClass.eachAttribute((name) => {\n        const key = this.keyForAttribute(name, 'deserialize');\n        if (key !== name && extracted[key] !== undefined) {\n          extracted[name] = extracted[key];\n          delete extracted[key];\n        }\n      });\n\n      typeClass.eachRelationship((name) => {\n        const key = this.keyForRelationship(name, 'deserialize');\n        if (key !== name && extracted[key] !== undefined) {\n          extracted[name] = extracted[key];\n          delete extracted[key];\n        }\n      });\n\n      return extracted;\n    }\n\n    return payload;\n  },\n\n  /**\n    `keyForAttribute` can be used to define rules for how to convert an\n    attribute name in your model to a key in your JSON.\n\n    Example\n\n    ```js [app/serializers/application.js]\n    import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n    import { underscore } from '<app-name>/utils/string-utils';\n\n    export default class ApplicationSerializer extends JSONSerializer {\n      keyForAttribute(attr, method) {\n        return underscore(attr).toUpperCase();\n      }\n    }\n    ```\n\n    @public\n  */\n  keyForAttribute(key: string, method: string): string {\n    return key;\n  },\n\n  /**\n    `keyForRelationship` can be used to define a custom key when\n    serializing and deserializing relationship properties. By default\n    `JSONSerializer` does not provide an implementation of this method.\n\n    Example\n\n      ```js [app/serializers/post.js]\n      import { JSONSerializer } from '@warp-drive/legacy/serializer/json';\n      import { underscore } from '<app-name>/utils/string-utils';\n\n      export default class PostSerializer extends JSONSerializer {\n        keyForRelationship(key, relationship, method) {\n          return `rel_${underscore(key)}`;\n        }\n      }\n      ```\n\n    @public\n  */\n  keyForRelationship(key: string, typeClass: ModelSchema | string, method?: string): string {\n    return key;\n  },\n\n  /**\n   `keyForLink` can be used to define a custom key when deserializing link\n   properties.\n\n    @public\n  */\n  keyForLink(key: string, kind: 'belongsTo' | 'hasMany'): string {\n    return key;\n  },\n\n  // HELPERS\n\n  /**\n   @private\n  */\n  transformFor(attributeType: string, skipAssertion?: boolean): Transform {\n    const transform = getOwner(this)!.lookup(`transform:${attributeType}`) as Transform | undefined;\n\n    assert(`Unable to find the transform for \\`attr('${attributeType}')\\``, skipAssertion || !!transform);\n\n    return transform!;\n  },\n});\n\nexport { JSONSerializer };\n"],"mappings":"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"}

package/dist/model/-private.d.ts

@@ -1,3 +1,3 @@
-import { d as MaybeHasManyFields, f as MaybeRelationshipFields, g as lookupLegacySupport, h as LEGACY_SUPPORT, i as Errors, m as PromiseBelongsTo, n as ModelStore, o as MinimalLegacyRecord, u as MaybeBelongsToFields, v as PromiseManyArray } from "../model-62hn5_PD.js";
+import { d as MaybeHasManyFields, f as MaybeRelationshipFields, g as lookupLegacySupport, h as LEGACY_SUPPORT, i as Errors, m as PromiseBelongsTo, n as ModelStore, o as MinimalLegacyRecord, u as MaybeBelongsToFields, v as PromiseManyArray } from "../model-BPVLf-rp.js";
 import { LegacyManyArray as ManyArray } from "@warp-drive/core/store/-private";
 export { Errors, LEGACY_SUPPORT, type ManyArray, type MaybeBelongsToFields, type MaybeHasManyFields, type MaybeRelationshipFields, type MinimalLegacyRecord, type ModelStore, PromiseBelongsTo, PromiseManyArray, lookupLegacySupport };

package/dist/model/-private.js

@@ -1,3 +1,3 @@
-import { a as PromiseManyArray, n as LEGACY_SUPPORT, o as PromiseBelongsTo, r as lookupLegacySupport, t as Errors } from "../errors-BlrR6--x.js";
+import { a as PromiseManyArray, n as LEGACY_SUPPORT, o as PromiseBelongsTo, r as lookupLegacySupport, t as Errors } from "../errors-BI0Xugyo.js";
 
 export { Errors, LEGACY_SUPPORT, PromiseBelongsTo, PromiseManyArray, lookupLegacySupport };

package/dist/model/migration-support.d.ts

@@ -1,5 +1,5 @@
-import { m as Snapshot } from "../compat-BbNNmTM-.js";
-import { _ as HasManyReference, a as RecordState, c as hasMany, d as MaybeHasManyFields, l as BelongsToReference, o as MinimalLegacyRecord, p as _MaybeBelongsToFields, s as belongsTo } from "../model-62hn5_PD.js";
+import { m as Snapshot } from "../compat-BZlQ-5eI.js";
+import { _ as HasManyReference, a as RecordState, c as hasMany, d as MaybeHasManyFields, l as BelongsToReference, o as MinimalLegacyRecord, p as _MaybeBelongsToFields, s as belongsTo } from "../model-BPVLf-rp.js";
 import { Store } from "@warp-drive/core";
 import { CAUTION_MEGA_DANGER_ZONE_Extension, ProcessedExtension } from "@warp-drive/core/reactive";
 import { ExtensibleField } from "@warp-drive/core/reactive/-private";
@@ -16,6 +16,9 @@ import { Derivation, HashFn, Transformation } from "@warp-drive/core/types/schem
  * Adds the `Model`-style `belongsTo`/`hasMany` reference methods to a
  * {@link TypedRecordInstance}, for use when migrating a resource from
  * `Model` to a schema-based record while preserving these APIs.
+ *
+ * @summary Legacy type that adds the `Model`-style `belongsTo` and `hasMany` reference methods to a typed record
+ * migrating from `Model` to a schema-based record.
  */
 export type WithLegacyDerivations<T extends TypedRecordInstance> = T & MinimalLegacyRecord & {
   /**
@@ -101,6 +104,8 @@ interface LegacyModeRecord<T extends TypedRecordInstance> {
  * }>
  * ```
  *
+ * @summary Legacy type that adds the `Model`-style state flags and methods (`save`, `isNew`, `errors`, etc.) that
+ * `withDefaults` provides to a LegacyMode record type.
  */
 export type WithLegacy<T extends TypedRecordInstance> = T & LegacyModeRecord<T>;
 /**
@@ -153,6 +158,8 @@ export type WithLegacy<T extends TypedRecordInstance> = T & LegacyModeRecord<T>;
  * registerDerivations(schema);
  * ```
  *
+ * @summary Legacy helper that marks a resource schema as LegacyMode and adds the fields that give its records
+ * `Model`-like state and methods.
  * @param schema The schema to add legacy support to.
  * @return The schema with legacy support added.
  * @public
@@ -176,6 +183,9 @@ export declare function withDefaults(schema: WithPartial<LegacyResourceSchema, "
  *   ]
  * });
  * ```
+ *
+ * @summary Legacy alternative to `withDefaults` that makes a LegacyMode schema whose `save`, `reload`, and
+ * `destroyRecord` run without deprecation warnings.
  */
 export declare function withRestoredDeprecatedModelRequestBehaviors(schema: WithPartial<LegacyResourceSchema, "legacy" | "identity">): LegacyResourceSchema;
 /**
@@ -185,6 +195,8 @@ export declare function withRestoredDeprecatedModelRequestBehaviors(schema: With
  * This must be called in order to use the fields added by {@link withDefaults} or
  * {@link withRestoredDeprecatedModelRequestBehaviors}.
  *
+ * @summary Legacy setup that registers the derivation, relationship behaviors, and extension a schema service needs to
+ * support LegacyMode records.
  * @param schema The schema service to register the derivations with.
  * @public
  */
@@ -217,6 +229,8 @@ export declare function registerDerivations(schema: SchemaService$1): void;
  * All calls to register resources, derivations, transformations, hash functions
  * etc. will be delegated to the primary schema service.
  *
+ * @summary Legacy schema service that serves a resource's schema from the primary service when it has one, and
+ * otherwise from its `Model` class, for incremental migration.
  * @class DelegatingSchemaService
  * @public
  */
@@ -243,6 +257,8 @@ export interface DelegatingSchemaService {
 }
 /**
  * See the {@link DelegatingSchemaService | class documentation above} for usage.
+ * @summary Legacy schema service that serves a resource's schema from the primary service when it has one, and
+ * otherwise from its `Model` class, for incremental migration.
  */
 export declare class DelegatingSchemaService implements SchemaService$1 {
   /** @internal */

package/dist/model/migration-support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-support.d.ts","names":[],"sources":["../../src/model/migration-support.ts"],"mappings":";;;;;;;;;;;;;;;;;;;YAsFY,sBAAsB,UAAU,uBAAuB,IACjE;;;;EAIE,kBAAkB;;;;EAIlB,gBAAgB;;KAGf,mBAAmB,WAAW,QAAQ;KACtC,sBAAsB,WAAW,QAAQ;UAEpC,iBAAiB,UAAU;EACnC;EAEA,UAAU,UAAU;EACpB,cAAc,UAAU,0BAA0B;EAClD;EACA,qBAAqB;EACrB;EACA,mBAAmB,SAAS;EAC5B,KAAK,UAAU,0BAA0B;EACzC,OAAO,UAAU,0BAA0B,QAAQ;EACnD,UAAU,UAAU,sBAAsB,IAAI,MAAM,IAAI,mBAAmB,GAAG;EAC9E,QAAQ,UAAU,mBAAmB,IAAI,MAAM,IAAI,iBAAiB,GAAG;EACvE;EAEA;EACA;IAAe,WAAW,iBAAiB;;EAC3C,cAAc;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAyEU,WAAW,UAAU,uBAAuB,IAAI,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqI7D,aAAa,QAAQ,YAAY,+CAA+C;;;;;;;;;;;;;;;;;;;;wBAqDhF,4CACd,QAAQ,YAAY,+CACnB;;;;;;;;;;;wBA2Ca,oBAAoB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAyH3B;;;;;EAKf,yBAAyB,UAAU;IAAgB;MAAiB;;;;;EAKpE,4BAA4B,UAAU;IAAgB;MAAiB;;;;;EAKvE,eAAe;;;;;qBAKJ,mCAAmC;;EAE9C,YAAa;;EAEb,YAAa;EAEb,YAAY,OAAO,OAAO,QAAQ;;;;;EASlC,YAAY,UAAU;IAAgB;;EAItC,iBAAiB;EAIjB,YAAY,UAAU;IAAgB;;EAGtC,SAAS;EAMT,iBAAiB,UAAU;IAAgB;KAAgB;EAM3D,OAAO,UAAU;IAAgB;MAAiB,YAAY;EAM9D,aAAa;IAAY;MAAiB,YAAY,QAAQ,sBAAsB;EASpF,eAAe,OAAO,eAAe,cAAc;IAAe;MAAiB;EAGnF,OAAO,OAAO;IAAc;MAAiB;EAG7C,WAAW,OAAO;IAAiB;MAAiB;EAGpD,SAAS,UAAU;IAAgB;MAAiB,iBAAiB;EAMrE,kBAAkB,SAAS,MAAM,iBAAiB;EAGlD,iBAAiB,QAAQ,iBAAiB;EAG1C,uBAAuB,WAAW;EAGlC,mBAAmB,GAAG,GAAG,WAAW,oBAAoB,YAAY,WAAW,GAAG,GAAG;EAGrF,eAAe,QAAQ;EAIvB,sCAAsC;IAAO;IAA0B;;EAIvE,2CAA2C,WAAW;EAItD,4CACE,UAAU;IAAgB;aAClB;EAIV,0CACE,OAAO,iBACP,qCACQ;EAIV,yCAAyC,OAAO,yBAAyB;;;;;;;;;;;;EAezE,cAAc,cAAc;;;;;;;;;;;;EAiB5B,MAAM,cAAc;;;;;iBAUL,uCAAuC;EACtD,YAAY;EACZ,YAAY"}
+{"version":3,"file":"migration-support.d.ts","names":["SchemaService","ResourceKey"],"sources":["../../src/model/migration-support.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;YA2FY,sBAAsB,UAAU,uBAAuB,IACjE;;;;EAIE,kBAAkB;;;;EAIlB,gBAAgB;;KAGf,mBAAmB,WAAW,QAAQA;KACtC,sBAAsB,WAAW,QAAQA;UAEpC,iBAAiB,UAAU;EACnC;EAEA,UAAU,UAAU;EACpB,cAAc,UAAU,0BAA0B;EAClD;EACA,qBAAqB;EACrB;EACA,mBAAmB,SAAS;EAC5B,KAAK,UAAU,0BAA0B;EACzC,OAAO,UAAU,0BAA0B,QAAQ;EACnD,UAAU,UAAU,sBAAsB,IAAI,MAAM,IAAI,mBAAmB,GAAG;EAC9E,QAAQ,UAAU,mBAAmB,IAAI,MAAM,IAAI,iBAAiB,GAAG;EACvE;EAEA;EACA;IAAe,WAAW,iBAAiB;;EAC3C,cAAc;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA2EU,WAAW,UAAU,uBAAuB,IAAI,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuI7D,aAAa,QAAQ,YAAY,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;wBAwDhF,4CACd,QAAQ,YAAY,+CACnB;;;;;;;;;;;;;wBA6Ca,oBAAoB,QAAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2H3B;;;;;EAKf,yBAAyB,UAAUC;IAAgB;MAAiB;;;;;EAKpE,4BAA4B,UAAUA;IAAgB;MAAiB;;;;;EAKvE,eAAe;;;;;;;qBAOJ,mCAAmCD;;EAE9C,YAAaA;;EAEb,YAAaA;EAEb,YAAY,OAAO,OAAO,QAAQA;;;;;EASlC,YAAY,UAAUC;IAAgB;;EAItC,iBAAiB;EAIjB,YAAY,UAAUA;IAAgB;;EAGtC,SAAS;EAMT,iBAAiB,UAAUA;IAAgB;KAAgB;EAM3D,OAAO,UAAUA;IAAgB;MAAiB,YAAY;EAM9D,aAAa;IAAY;MAAiB,YAAY,QAAQ,sBAAsB;EASpF,eAAe,OAAO,eAAe,cAAc;IAAe;MAAiB;EAGnF,OAAO,OAAO;IAAc;MAAiB;EAG7C,WAAW,OAAO;IAAiB;MAAiB;EAGpD,SAAS,UAAUA;IAAgB;MAAiB,iBAAiB;EAMrE,kBAAkB,SAAS,MAAM,iBAAiB;EAGlD,iBAAiB,QAAQ,iBAAiB;EAG1C,uBAAuB,WAAW;EAGlC,mBAAmB,GAAG,GAAG,WAAW,oBAAoB,YAAY,WAAW,GAAG,GAAG;EAGrF,eAAe,QAAQ;EAIvB,sCAAsC;IAAO;IAA0B;;EAIvE,2CAA2C,WAAW;EAItD,4CACE,UAAUA;IAAgB;aAClB;EAIV,0CACE,OAAO,iBACP,qCACQ;EAIV,yCAAyC,OAAO,yBAAyB;;;;;;;;;;;;EAezE,cAAc,cAAc;;;;;;;;;;;;EAiB5B,MAAM,cAAc;;;;;iBAUL,uCAAuC;EACtD,YAAYD;EACZ,YAAYA"}