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

package/dist/unpkg/{prod/compat-DxiVkCUb.js → prod-deprecated/compat-PrUuencH.js}

@@ -1,16 +1,15 @@
-import { a as normalizeResponseHelper, n as FetchManager, o as assertIdentifierHasId, r as SaveOp, s as SnapshotRecordArray, t as upgradeStore } from "./-private-SfXkkHKd.js";
+import { a as normalizeResponseHelper, n as FetchManager, o as assertIdentifierHasId, r as SaveOp, s as SnapshotRecordArray, t as upgradeStore } from "./-private-DuRzYAyW.js";
 import { recordIdentifierFor } from "@warp-drive/core";
 import { getOwner } from "@ember/application";
 import { _deprecatingNormalize, assertPrivateStore } from "@warp-drive/core/store/-private";
 
-//#region src/compat/legacy-network-handler/legacy-data-utils.ts
+// src/compat/legacy-network-handler/legacy-data-utils.ts
 function iterateData(data, fn) {
 	if (Array.isArray(data)) return data.map(fn);
 	else return fn(data, 0);
 }
 
-//#endregion
-//#region src/compat/legacy-network-handler/legacy-data-fetch.ts
+// src/compat/legacy-network-handler/legacy-data-fetch.ts
 function _findHasMany(adapter, store, identifier, link, relationship, options) {
 	/* @__PURE__ */ upgradeStore(store);
 	return Promise.resolve().then(() => {
@@ -113,8 +112,7 @@ function fixRelationshipData(relationshipData, relationshipKind, { id, type }) {
 	return payload;
 }
 
-//#endregion
-//#region src/compat/legacy-network-handler/legacy-network-handler.ts
+// src/compat/legacy-network-handler/legacy-network-handler.ts
 const PotentialLegacyOperations = /* @__PURE__ */ new Set([
 	"findRecord",
 	"findAll",
@@ -132,6 +130,9 @@ const PotentialLegacyOperations = /* @__PURE__ */ new Set([
 * `deleteRecord` requests using the store's configured {@link MinimumAdapterInterface | adapter}
 * and {@link MinimumSerializerInterface | serializer}, passing any other
 * request through to the next handler unchanged.
+*
+* @summary Legacy `RequestManager` handler that fulfills find, query, create, update, and delete operations through
+* the store's adapters and serializers, passing other requests along.
 */
 const LegacyNetworkHandler = { request(context, next) {
 	if (context.request.url || !context.request.op || !PotentialLegacyOperations.has(context.request.op)) return next(context.request);
@@ -344,17 +345,57 @@ function queryRecord(context) {
 	});
 }
 
-//#endregion
-//#region src/compat.ts
+// src/compat.ts
+/**
+* Helps an app migrate incrementally from legacy EmberData patterns to modern ***Warp*Drive**.
+*
+* ## Why it exists
+*
+* While migrating, you may need to:
+*
+* - keep Adapters and Serializers working on a Store whose requests go through the
+*   {@link RequestManager}
+* - keep the deprecated request methods such as `store.findRecord` and `store.query`, which
+*   Adapters fulfill, working while you move calls to `store.request`
+* - adopt modern patterns one piece at a time rather than all at once
+*
+* ## What it provides
+*
+* - {@link LegacyNetworkHandler}, a request handler that fulfills those legacy requests through
+*   the store's Adapters and Serializers and passes every other request along
+* - {@link adapterFor}, {@link serializerFor}, {@link normalize}, {@link pushPayload} and
+*   {@link serializeRecord}, the store methods for working with Adapters and Serializers, and
+*   {@link LegacyStoreCompat}, the Store type that includes them
+*
+* The Store that [useLegacyStore](/api/@warp-drive/legacy/functions/useLegacyStore) produces
+* adds `LegacyNetworkHandler` to its RequestManager unless `linksMode` is `true`. The hooks
+* that present `Model` instances live in [@warp-drive/legacy/model](/api/@warp-drive/legacy/model/),
+* not here.
+*
+* ## When to use it
+*
+* Only during a migration from legacy EmberData to modern ***Warp*Drive**. It lets you adopt
+* modern patterns incrementally while your existing Adapters and Serializers keep working. For
+* incremental migration strategies, see the [Migration Guide](/upgrading/v5/) and the
+* [Two Store Migration Strategy](/upgrading/v5/two-store-migration).
+*
+* @module
+* @summary Legacy store support for adapters and serializers: the `LegacyNetworkHandler` plus store methods such as
+* `adapterFor`, `serializerFor`, `normalize` and `pushPayload`.
+*/
 /**
 * Extends the signature of {@link Store} with additional
 * methods available when using the legacy network layer.
 *
+* @summary Legacy `Store` type extended with `adapterFor`, `serializerFor`, `normalize`, `pushPayload`, and
+* `serializeRecord` from the adapter and serializer network layer.
 * @public
 * @noInheritDoc
 * @legacy
 */
 /**
+* @summary Deprecated alias of `LegacyStoreCompat`, the `Store` type extended with legacy adapter and serializer
+* methods.
 * @deprecated - use {@link LegacyStoreCompat} instead
 */
 /**
@@ -366,6 +407,8 @@ If no `person` adapter is found, this method will look
 for an `application` adapter (the default adapter for
 your entire application).
 
+@summary Legacy store method that returns the cached adapter for a model type, falling back to the `application`
+adapter.
 @public
 @param modelName
 */
@@ -401,6 +444,8 @@ your entire application).
 If a serializer cannot be found on the adapter, it will fall back
 to an instance of `JSONSerializer`.
 
+@summary Legacy store method that returns the cached serializer for a model type, falling back to the
+`application` serializer, or `null` if neither exists.
 @public
 @param modelName the record to serialize
 */
@@ -444,6 +489,8 @@ store.push(store.normalize(modelName, data));
 });
 ```
 
+@summary Legacy store method that converts a raw payload into the normalized document `store.push` expects, using
+the serializer for the given model type.
 @legacy
 @public
 @param modelName The name of the model type for this payload
@@ -507,6 +554,8 @@ store.pushPayload(pushData); // Will use the application serializer
 store.pushPayload('post', pushData); // Will use the post serializer
 ```
 
+@summary Legacy store method that pushes a raw payload into the store after the application serializer, or the
+given model type's serializer, normalizes it.
 @public
 @param modelName Optionally, a model type used to determine which serializer will be used
 @param inputPayload
@@ -520,6 +569,8 @@ function pushPayload(modelName, inputPayload) {
 /**
 * Serializes a record using the store's legacy network layer, as with
 * {@link LegacyStoreCompat.serializeRecord | store.serializeRecord}.
+*
+* @summary Legacy store method that serializes a record into a payload using its model type's serializer.
 */
 function serializeRecord(record, options) {
 	/* @__PURE__ */ upgradeStore(this);
@@ -529,6 +580,8 @@ function serializeRecord(record, options) {
 /**
 * Destroys any adapters/serializers the legacy network layer has created
 * for this store, invoked when the store itself is destroyed.
+*
+* @summary Legacy store teardown hook that destroys every adapter and serializer instance the store has cached.
 */
 function cleanup() {
 	/* @__PURE__ */ upgradeStore(this);
@@ -542,6 +595,5 @@ function cleanup() {
 	}
 }
 
-//#endregion
 export { serializeRecord as a, pushPayload as i, cleanup as n, serializerFor as o, normalize as r, LegacyNetworkHandler as s, adapterFor as t };
-//# sourceMappingURL=compat-DxiVkCUb.js.map
+//# sourceMappingURL=compat-PrUuencH.js.map

package/dist/unpkg/prod-deprecated/compat-PrUuencH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-PrUuencH.js","names":["upgradeStore","iterateData","payloadIsNotBlank","normalizeResponseHelper","_findHasMany","adapter","store","identifier","link","relationship","options","promise","Promise","resolve","then","snapshot","_fetchManager","createSnapshot","useLink","relatedLink","href","findHasMany","adapterPayload","modelClass","modelFor","type","serializer","serializerFor","payload","syncRelationshipDataFromLink","_push","_findBelongsTo","adapterFor","findBelongsTo","data","links","meta","parentIdentifier","relationshipData","index","id","ensureRelationshipIsSetToParent","relatedDataHash","parentPayload","relationships","name","Array","isArray","included","push","parentRelationship","inverse","getInverse","inverseKey","kind","fixRelationshipData","inverseForRelationship","key","definition","schema","fields","get","lhs_relationshipName","parentType","relationshipDataPointsToParent","length","i","entry","validateRelationshipEntry","relationshipKind","parentRelationshipData","relData","found","find","v","Object","assign","parentModelID","toString","waitFor","assertPrivateStore","upgradeStore","FetchManager","SaveOp","assertIdentifierHasId","_findBelongsTo","_findHasMany","payloadIsNotBlank","normalizeResponseHelper","SnapshotRecordArray","PotentialLegacyOperations","Set","LegacyNetworkHandler","request","context","next","url","op","has","store","_fetchManager","findRecord","findAll","query","queryRecord","findBelongsTo","findHasMany","saveRecord","data","records","identifiers","options","record","links","useLink","field","identifier","pendingRequest","getPendingFetch","related","manager","reload","scheduleFetch","fetchDataIfNeededForIdentifier","adapter","adapterFor","type","fetches","Array","length","i","Promise","all","operation","cache","willCommit","saveOptions","Object","assign","fetchManagerPromise","scheduleSave","then","payload","result","_join","didCommit","content","lifetimes","didRequest","status","peekRecord","catch","e","err","Error","adapterDidInvalidate","error","isAdapterError","code","serializer","serializerFor","extractErrors","errorsHash","modelFor","id","errors","errorsHashToArray","jsonApiErrors","title","detail","source","pointer","commitWasRejected","makeArray","value","isArray","PRIMARY_ATTRIBUTE_KEY","out","keys","forEach","key","messages","push","promise","_instanceCache","recordIsLoaded","snapshot","shouldReloadRecord","createSnapshot","backgroundReload","shouldBackgroundReloadRecord","resolve","maybeRecordArray","recordArrayManager","_live","get","snapshotArray","shouldReload","shouldReloadAll","fetch","isUpdating","_findAll","peekAll","shouldBackgroundReloadAll","isAsyncFlush","schema","adapterPayload","_push","_recordArray","recordArray","getCollection","populateManagedArray","assertSingleResourceDocument","getOwner","recordIdentifierFor","_deprecatingNormalize","FetchManager","upgradeStore","LegacyNetworkHandler","adapterFor","modelName","_allowMissing","_adapterCache","Object","create","normalizedModelName","adapter","owner","lookup","undefined","application","serializerFor","_serializerCache","serializer","normalize","payload","schema","modelFor","pushPayload","inputPayload","serializeRecord","record","options","_fetchManager","createSnapshot","serialize","cleanup","adapterName","destroy","serializerName"],"sources":["../../../src/compat/legacy-network-handler/legacy-data-utils.ts","../../../src/compat/legacy-network-handler/legacy-data-fetch.ts","../../../src/compat/legacy-network-handler/legacy-network-handler.ts","../../../src/compat.ts"],"sourcesContent":["import type { AdapterPayload } from './minimum-adapter-interface.ts';\n\ntype IteratorCB<T> = ((o: T, index: number) => T) | ((o: T) => T);\n\nexport function iterateData<T>(data: T[] | T, fn: IteratorCB<T>): T | T[] {\n  if (Array.isArray(data)) {\n    return data.map(fn);\n  } else {\n    return fn(data, 0);\n  }\n}\n\nexport function payloadIsNotBlank<T>(adapterPayload: T | AdapterPayload): adapterPayload is AdapterPayload {\n  if (Array.isArray(adapterPayload)) {\n    return true;\n  } else {\n    return Object.keys(adapterPayload || {}).length !== 0;\n  }\n}\n","import type { Store } from '@warp-drive/core';\nimport { DEBUG } from '@warp-drive/core/build-config/env';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { BaseFinderOptions } from '@warp-drive/core/types';\nimport type { PersistedResourceKey, ResourceKey } from '@warp-drive/core/types/identifier';\nimport type { LegacyRelationshipField as RelationshipSchema } from '@warp-drive/core/types/schema/fields';\nimport type { ExistingResourceObject, JsonApiDocument } from '@warp-drive/core/types/spec/json-api-raw';\n\nimport { upgradeStore } from '../-private.ts';\nimport { iterateData, payloadIsNotBlank } from './legacy-data-utils.ts';\nimport type { MinimumAdapterInterface } from './minimum-adapter-interface.ts';\nimport { normalizeResponseHelper } from './serializer-response.ts';\n\nexport function _findHasMany(\n  adapter: MinimumAdapterInterface,\n  store: Store,\n  identifier: ResourceKey,\n  link: string | null | { href: string },\n  relationship: RelationshipSchema,\n  options: BaseFinderOptions\n): Promise<PersistedResourceKey[]> {\n  upgradeStore(store);\n  const promise = Promise.resolve().then(() => {\n    const snapshot = store._fetchManager.createSnapshot(identifier, options);\n    const useLink = !link || typeof link === 'string';\n    const relatedLink = useLink ? link : link.href;\n    assert(\n      `Attempted to load a hasMany relationship from a specified 'link' in the original payload, but the specified link is empty. You must provide a valid 'link' in the original payload to use 'findHasMany'`,\n      relatedLink\n    );\n    assert(\n      `Expected the adapter to implement 'findHasMany' but it does not`,\n      typeof adapter.findHasMany === 'function'\n    );\n    return adapter.findHasMany(store, snapshot, relatedLink, relationship);\n  });\n\n  return promise.then((adapterPayload) => {\n    assert(\n      `You made a 'findHasMany' request for a ${identifier.type}'s '${\n        relationship.name\n      }' relationship, using link '${JSON.stringify(link)}' , but the adapter's response did not have any data`,\n      payloadIsNotBlank(adapterPayload)\n    );\n    const modelClass = store.modelFor(relationship.type);\n\n    const serializer = store.serializerFor(relationship.type);\n    let payload = normalizeResponseHelper(serializer, store, modelClass, adapterPayload, null, 'findHasMany');\n\n    assert(\n      `fetched the hasMany relationship '${relationship.name}' for ${identifier.type}:${\n        identifier.id\n      } with link '${JSON.stringify(\n        link\n      )}', but no data member is present in the response. If no data exists, the response should set { data: [] }`,\n      'data' in payload && Array.isArray(payload.data)\n    );\n\n    payload = syncRelationshipDataFromLink(store, payload, identifier as ResourceIdentity, relationship);\n    return store._push(payload, true) as PersistedResourceKey[];\n  }, null);\n}\n\nexport function _findBelongsTo(\n  store: Store,\n  identifier: ResourceKey,\n  link: string | null | { href: string },\n  relationship: RelationshipSchema,\n  options: BaseFinderOptions\n): Promise<PersistedResourceKey | null> {\n  upgradeStore(store);\n  const promise = Promise.resolve().then(() => {\n    const adapter = store.adapterFor(identifier.type);\n    assert(`You tried to load a belongsTo relationship but you have no adapter (for ${identifier.type})`, adapter);\n    assert(\n      `You tried to load a belongsTo relationship from a specified 'link' in the original payload but your adapter does not implement 'findBelongsTo'`,\n      typeof adapter.findBelongsTo === 'function'\n    );\n    const snapshot = store._fetchManager.createSnapshot(identifier, options);\n    const useLink = !link || typeof link === 'string';\n    const relatedLink = useLink ? link : link.href;\n    assert(\n      `Attempted to load a belongsTo relationship from a specified 'link' in the original payload, but the specified link is empty. You must provide a valid 'link' in the original payload to use 'findBelongsTo'`,\n      relatedLink\n    );\n    return adapter.findBelongsTo(store, snapshot, relatedLink, relationship);\n  });\n\n  return promise.then((adapterPayload) => {\n    const modelClass = store.modelFor(relationship.type);\n    const serializer = store.serializerFor(relationship.type);\n    let payload = normalizeResponseHelper(serializer, store, modelClass, adapterPayload, null, 'findBelongsTo');\n\n    assert(\n      `fetched the belongsTo relationship '${relationship.name}' for ${identifier.type}:${\n        identifier.id\n      } with link '${JSON.stringify(\n        link\n      )}', but no data member is present in the response. If no data exists, the response should set { data: null }`,\n      'data' in payload && (payload.data === null || (typeof payload.data === 'object' && !Array.isArray(payload.data)))\n    );\n\n    if (!payload.data && !payload.links && !payload.meta) {\n      return null;\n    }\n\n    payload = syncRelationshipDataFromLink(store, payload, identifier as ResourceIdentity, relationship);\n\n    return store._push(payload, true) as PersistedResourceKey | null;\n  }, null);\n}\n\n// sync\n// iterate over records in payload.data\n// for each record\n//   assert that record.relationships[inverse] is either undefined (so we can fix it)\n//     or provide a data: {id, type} that matches the record that requested it\n//   return the relationship data for the parent\nfunction syncRelationshipDataFromLink(\n  store: Store,\n  payload: JsonApiDocument,\n  parentIdentifier: ResourceIdentity,\n  relationship: RelationshipSchema\n) {\n  // ensure the right hand side (incoming payload) points to the parent record that\n  // requested this relationship\n  const relationshipData = payload.data\n    ? iterateData(payload.data, (data, index) => {\n        const { id, type } = data;\n        ensureRelationshipIsSetToParent(data, parentIdentifier, store, relationship, index);\n        return { id, type };\n      })\n    : null;\n\n  const relatedDataHash = {} as JsonApiDocument;\n\n  if ('meta' in payload) {\n    relatedDataHash.meta = payload.meta;\n  }\n  if ('links' in payload) {\n    relatedDataHash.links = payload.links;\n  }\n  if ('data' in payload) {\n    relatedDataHash.data = relationshipData;\n  }\n\n  // now, push the left hand side (the parent record) to ensure things are in sync, since\n  // the payload will be pushed with store._push\n  const parentPayload = {\n    id: parentIdentifier.id,\n    type: parentIdentifier.type,\n    relationships: {\n      [relationship.name]: relatedDataHash,\n    },\n  };\n\n  if (!Array.isArray(payload.included)) {\n    payload.included = [];\n  }\n  payload.included.push(parentPayload);\n\n  return payload;\n}\n\ntype ResourceIdentity = { id: string; type: string };\ntype RelationshipData = ResourceIdentity | ResourceIdentity[] | null;\n\nfunction ensureRelationshipIsSetToParent(\n  payload: ExistingResourceObject,\n  parentIdentifier: ResourceIdentity,\n  store: Store,\n  parentRelationship: RelationshipSchema,\n  index: number\n) {\n  const { id, type } = payload;\n\n  if (!payload.relationships) {\n    payload.relationships = {};\n  }\n  const { relationships } = payload;\n\n  const inverse = getInverse(store, parentIdentifier, parentRelationship, type);\n  if (inverse) {\n    const { inverseKey, kind } = inverse;\n\n    const relationshipData = relationships[inverseKey]?.data;\n\n    if (DEBUG) {\n      if (\n        typeof relationshipData !== 'undefined' &&\n        !relationshipDataPointsToParent(relationshipData, parentIdentifier)\n      ) {\n        const inspect = function inspect(thing: unknown) {\n          return `'${JSON.stringify(thing)}'`;\n        };\n        const quotedType = inspect(type);\n        const quotedInverse = inspect(inverseKey);\n        const expected = inspect({\n          id: parentIdentifier.id,\n          type: parentIdentifier.type,\n        });\n        const expectedModel = `${parentIdentifier.type}:${parentIdentifier.id}`;\n        const got = inspect(relationshipData);\n        const prefix = typeof index === 'number' ? `data[${index}]` : `data`;\n        const path = `${prefix}.relationships.${inverseKey}.data`;\n        const data = Array.isArray(relationshipData) ? relationshipData[0] : relationshipData;\n        const other = data ? `<${data.type}:${data.id}>` : null;\n        const relationshipFetched = `${expectedModel}.${parentRelationship.kind}(\"${parentRelationship.name}\")`;\n        const includedRecord = `<${type}:${id}>`;\n        const message = [\n          `Encountered mismatched relationship: WarpDrive expected ${path} in the payload from ${relationshipFetched} to include ${expected} but got ${got} instead.\\n`,\n          `The ${includedRecord} record loaded at ${prefix} in the payload specified ${other} as its ${quotedInverse}, but should have specified ${expectedModel} (the record the relationship is being loaded from) as its ${quotedInverse} instead.`,\n          `This could mean that the response for ${relationshipFetched} may have accidentally returned ${quotedType} records that aren't related to ${expectedModel} and could be related to a different ${parentIdentifier.type} record instead.`,\n          `WarpDrive has corrected the ${includedRecord} record's ${quotedInverse} relationship to ${expectedModel} so that ${relationshipFetched} will include ${includedRecord}.`,\n          `Please update the response from the server or change your serializer to either ensure that the response for only includes ${quotedType} records that specify ${expectedModel} as their ${quotedInverse}, or omit the ${quotedInverse} relationship from the response.`,\n        ].join('\\n');\n\n        assert(message);\n      }\n    }\n\n    if (kind !== 'hasMany' || typeof relationshipData !== 'undefined') {\n      relationships[inverseKey] = relationships[inverseKey] || {};\n      relationships[inverseKey].data = fixRelationshipData(relationshipData ?? null, kind, parentIdentifier);\n    }\n  }\n}\n\nfunction inverseForRelationship(store: Store, identifier: { type: string; id?: string }, key: string) {\n  const definition = store.schema.fields(identifier).get(key);\n  if (!definition) {\n    return null;\n  }\n  assert(\n    `Expected the field definition to be a relationship`,\n    definition.kind === 'hasMany' || definition.kind === 'belongsTo'\n  );\n  assert(\n    `Expected the relationship defintion to specify the inverse type or null.`,\n    definition.options?.inverse === null ||\n      (typeof definition.options?.inverse === 'string' && definition.options.inverse.length > 0)\n  );\n  return definition.options.inverse;\n}\n\nfunction getInverse(\n  store: Store,\n  parentIdentifier: ResourceIdentity,\n  parentRelationship: RelationshipSchema,\n  type: string\n) {\n  const { name: lhs_relationshipName } = parentRelationship;\n  const { type: parentType } = parentIdentifier;\n  const inverseKey = inverseForRelationship(store, { type: parentType }, lhs_relationshipName);\n\n  if (inverseKey) {\n    const definition = store.schema.fields({ type }).get(inverseKey);\n    assert(\n      `Expected the field definition to be a relationship`,\n      definition && (definition.kind === 'hasMany' || definition.kind === 'belongsTo')\n    );\n    return {\n      inverseKey,\n      kind: definition.kind,\n    };\n  }\n}\n\nfunction relationshipDataPointsToParent(relationshipData: RelationshipData, identifier: ResourceIdentity): boolean {\n  if (relationshipData === null) {\n    return false;\n  }\n\n  if (Array.isArray(relationshipData)) {\n    if (relationshipData.length === 0) {\n      return false;\n    }\n    for (let i = 0; i < relationshipData.length; i++) {\n      const entry = relationshipData[i];\n      if (validateRelationshipEntry(entry, identifier)) {\n        return true;\n      }\n    }\n  } else {\n    return validateRelationshipEntry(relationshipData, identifier);\n  }\n\n  return false;\n}\n\nfunction fixRelationshipData(\n  relationshipData: RelationshipData,\n  relationshipKind: 'hasMany' | 'belongsTo',\n  { id, type }: ResourceIdentity\n) {\n  const parentRelationshipData = {\n    id,\n    type,\n  };\n\n  let payload: { type: string; id: string } | { type: string; id: string }[];\n\n  if (relationshipKind === 'hasMany') {\n    const relData = (relationshipData as { type: string; id: string }[]) || [];\n    if (relationshipData) {\n      assert('expected the relationship data to be an array', Array.isArray(relationshipData));\n      // these arrays could be massive so this is better than filter\n      // Note: this is potentially problematic if type/id are not in the\n      // same state of normalization.\n      const found = relationshipData.find((v) => {\n        return v.type === parentRelationshipData.type && v.id === parentRelationshipData.id;\n      });\n      if (!found) {\n        relData.push(parentRelationshipData);\n      }\n    } else {\n      relData.push(parentRelationshipData);\n    }\n    payload = relData;\n  } else {\n    const relData = (relationshipData as { type: string; id: string }) || {};\n    Object.assign(relData, parentRelationshipData);\n    payload = relData;\n  }\n\n  return payload;\n}\n\nfunction validateRelationshipEntry({ id }: ResourceIdentity, { id: parentModelID }: ResourceIdentity): boolean {\n  return !!id && id.toString() === parentModelID;\n}\n","import type { Store, StoreRequestContext } from '@warp-drive/core';\nimport { LOG_REQUESTS } from '@warp-drive/core/build-config/debugging';\nimport { DEBUG, TESTING } from '@warp-drive/core/build-config/env';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport type { Future, Handler, NextFn } from '@warp-drive/core/request';\nimport { waitFor } from '@warp-drive/core/signals/-leaked';\nimport { assertPrivateStore, type LegacyQueryArray } from '@warp-drive/core/store/-private';\nimport type { ModelSchema } from '@warp-drive/core/types';\nimport type { PersistedResourceKey, ResourceKey } from '@warp-drive/core/types/identifier';\nimport type { ImmutableRequestInfo, StructuredDataDocument } from '@warp-drive/core/types/request';\nimport type { LegacyRelationshipField as RelationshipSchema } from '@warp-drive/core/types/schema/fields';\nimport type { SingleResourceDataDocument } from '@warp-drive/core/types/spec/document';\nimport type { ApiError } from '@warp-drive/core/types/spec/error';\nimport type {\n  CollectionResourceDocument,\n  JsonApiDocument,\n  Links,\n  PaginationLinks,\n  SingleResourceDocument,\n} from '@warp-drive/core/types/spec/json-api-raw';\n\nimport { upgradeStore } from '../-private.ts';\nimport { FetchManager, SaveOp } from './fetch-manager.ts';\nimport { assertIdentifierHasId } from './identifier-has-id.ts';\nimport { _findBelongsTo, _findHasMany } from './legacy-data-fetch.ts';\nimport { payloadIsNotBlank } from './legacy-data-utils.ts';\nimport type { MinimumAdapterInterface } from './minimum-adapter-interface.ts';\nimport type { MinimumSerializerInterface } from './minimum-serializer-interface.ts';\nimport { normalizeResponseHelper } from './serializer-response.ts';\nimport { SnapshotRecordArray } from './snapshot-record-array.ts';\nimport type { Snapshot } from './snapshot.ts';\n\ntype AdapterErrors = Error & { errors?: unknown[]; isAdapterError?: true; code?: string };\ntype SerializerWithParseErrors = MinimumSerializerInterface & {\n  extractErrors?(store: Store, modelClass: ModelSchema, error: AdapterErrors, recordId: string | null): unknown;\n};\n\nconst PotentialLegacyOperations = new Set([\n  'findRecord',\n  'findAll',\n  'query',\n  'queryRecord',\n  'findBelongsTo',\n  'findHasMany',\n  'updateRecord',\n  'createRecord',\n  'deleteRecord',\n]);\n\n/**\n * A {@link Handler} that fulfills legacy `findRecord`/`findAll`/`query`/\n * `queryRecord`/`findBelongsTo`/`findHasMany`/`createRecord`/`updateRecord`/\n * `deleteRecord` requests using the store's configured {@link MinimumAdapterInterface | adapter}\n * and {@link MinimumSerializerInterface | serializer}, passing any other\n * request through to the next handler unchanged.\n *\n * @summary Legacy `RequestManager` handler that fulfills find, query, create, update, and delete operations through\n * the store's adapters and serializers, passing other requests along.\n */\nexport const LegacyNetworkHandler: Handler = {\n  request<T>(context: StoreRequestContext, next: NextFn<T>): Future<T> | Promise<StructuredDataDocument<T>> {\n    // if we are not a legacy request, move on\n    if (context.request.url || !context.request.op || !PotentialLegacyOperations.has(context.request.op)) {\n      return next(context.request);\n    }\n\n    const { store } = context.request;\n    upgradeStore(store);\n    if (!store._fetchManager) {\n      store._fetchManager = new FetchManager(store);\n    }\n\n    switch (context.request.op) {\n      case 'findRecord':\n        return findRecord(context);\n      case 'findAll':\n        return findAll(context);\n      case 'query':\n        return query(context);\n      case 'queryRecord':\n        return queryRecord(context);\n      case 'findBelongsTo':\n        return findBelongsTo(context);\n      case 'findHasMany':\n        return findHasMany(context);\n      case 'updateRecord':\n        return saveRecord(context);\n      case 'createRecord':\n        return saveRecord(context);\n      case 'deleteRecord':\n        return saveRecord(context);\n      default:\n        return next(context.request);\n    }\n  },\n};\n\nfunction findBelongsTo<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data, records: identifiers } = context.request;\n  const { options, record, links, useLink, field } = data as {\n    record: ResourceKey;\n    options: Record<string, unknown>;\n    links?: Links;\n    useLink: boolean;\n    field: RelationshipSchema;\n  };\n  const identifier = identifiers?.[0];\n  upgradeStore(store);\n\n  // short circuit if we are already loading\n  const pendingRequest = identifier && store._fetchManager.getPendingFetch(identifier as PersistedResourceKey, options);\n  if (pendingRequest) {\n    return pendingRequest as Promise<T>;\n  }\n\n  if (useLink) {\n    assert(`Expected a related link when calling store.findBelongsTo, found ${String(links)}`, links && links.related);\n    return _findBelongsTo(store, record, links.related, field, options) as Promise<T>;\n  }\n\n  assert(`Expected an identifier`, Array.isArray(identifiers) && identifiers.length === 1);\n\n  const manager = store._fetchManager;\n  assertIdentifierHasId(identifier);\n\n  return options.reload\n    ? (manager.scheduleFetch(identifier, options, context.request) as Promise<T>)\n    : (manager.fetchDataIfNeededForIdentifier(identifier, options, context.request) as Promise<T>);\n}\n\nfunction findHasMany<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data, records: identifiers } = context.request;\n  const { options, record, links, useLink, field } = data as {\n    record: ResourceKey;\n    options: Record<string, unknown>;\n    links?: PaginationLinks | Links;\n    useLink: boolean;\n    field: RelationshipSchema;\n  };\n  upgradeStore(store);\n\n  // link case\n  if (useLink) {\n    const adapter = store.adapterFor(record.type);\n    /*\n    If a relationship was originally populated by the adapter as a link\n    (as opposed to a list of IDs), this method is called when the\n    relationship is fetched.\n\n    The link (which is usually a URL) is passed through unchanged, so the\n    adapter can make whatever request it wants.\n\n    The usual use-case is for the server to register a URL as a link, and\n    then use that URL in the future to make a request for the relationship.\n  */\n    assert(`You tried to load a hasMany relationship but you have no adapter (for ${record.type})`, adapter);\n    assert(\n      `You tried to load a hasMany relationship from a specified 'link' in the original payload but your adapter does not implement 'findHasMany'`,\n      typeof adapter.findHasMany === 'function'\n    );\n    assert(`Expected a related link when calling store.findHasMany, found ${String(links)}`, links && links.related);\n\n    return _findHasMany(adapter, store, record, links.related, field, options) as Promise<T>;\n  }\n\n  // identifiers case\n  assert(`Expected an array of identifiers to fetch`, Array.isArray(identifiers));\n  const fetches = new Array<globalThis.Promise<ResourceKey>>(identifiers.length);\n  const manager = store._fetchManager;\n\n  for (let i = 0; i < identifiers.length; i++) {\n    const identifier = identifiers[i];\n    // TODO we probably can be lenient here and return from cache for the isNew case\n    assertIdentifierHasId(identifier);\n    fetches[i] = options.reload\n      ? manager.scheduleFetch(identifier, options, context.request)\n      : manager.fetchDataIfNeededForIdentifier(identifier, options, context.request);\n  }\n\n  return Promise.all(fetches) as Promise<T>;\n}\n\nfunction saveRecord<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data, op: operation } = context.request;\n  const { options, record: identifier } = data as { record: ResourceKey; options: Record<string, unknown> };\n\n  upgradeStore(store);\n  assertPrivateStore(store);\n\n  store.cache.willCommit(identifier, context);\n\n  const saveOptions = Object.assign(\n    { [SaveOp]: operation as 'updateRecord' | 'deleteRecord' | 'createRecord' },\n    options\n  );\n  const fetchManagerPromise = store._fetchManager.scheduleSave(identifier, saveOptions);\n\n  return fetchManagerPromise\n    .then((payload) => {\n      let result: SingleResourceDataDocument;\n      store._join(() => {\n        // @ts-expect-error we don't have access to a response in legacy\n        result = store.cache.didCommit(identifier, { request: context.request, content: payload });\n      });\n\n      // blatantly lie if we were a createRecord request\n      // to give some semblance of cache-control to the\n      // CachePolicy while legacy is still around\n      if (store.lifetimes?.didRequest && operation === 'createRecord') {\n        store.lifetimes.didRequest(context.request, { status: 201 } as Response, null, store);\n      }\n      return store.peekRecord(result!.data!);\n    })\n    .catch((e: unknown) => {\n      let err = e;\n      if (!e) {\n        err = new Error(`Unknown Error Occurred During Request`);\n      } else if (typeof e === 'string') {\n        err = new Error(e);\n      }\n      adapterDidInvalidate(store, identifier, err as Error);\n      throw err;\n    }) as Promise<T>;\n}\n\nfunction adapterDidInvalidate(\n  store: Store,\n  identifier: ResourceKey,\n  error: Error & { errors?: ApiError[]; isAdapterError?: true; code?: string }\n) {\n  upgradeStore(store);\n  if (error && error.isAdapterError === true && error.code === 'InvalidError') {\n    const serializer = store.serializerFor(identifier.type) as SerializerWithParseErrors;\n\n    // TODO @deprecate extractErrors being called\n    // TODO remove extractErrors from the default serializers.\n    if (serializer && typeof serializer.extractErrors === 'function') {\n      const errorsHash = serializer.extractErrors(\n        store,\n        store.modelFor(identifier.type),\n        error,\n        identifier.id\n      ) as Record<string, string | string[]>;\n      error.errors = errorsHashToArray(errorsHash);\n    }\n  }\n  const cache = store.cache;\n\n  if (error.errors) {\n    assert(\n      `Expected the cache in use by resource ${String(\n        identifier\n      )} to have a getErrors(identifier) method for retrieving errors.`,\n      typeof cache.getErrors === 'function'\n    );\n\n    let jsonApiErrors: ApiError[] = error.errors;\n    if (jsonApiErrors.length === 0) {\n      jsonApiErrors = [{ title: 'Invalid Error', detail: '', source: { pointer: '/data' } }];\n    }\n    cache.commitWasRejected(identifier, jsonApiErrors);\n  } else {\n    cache.commitWasRejected(identifier);\n  }\n}\n\nfunction makeArray<T>(value: T | T[]): T[] {\n  return Array.isArray(value) ? value : [value];\n}\n\nconst PRIMARY_ATTRIBUTE_KEY = 'base';\nfunction errorsHashToArray(errors: Record<string, string | string[]>): ApiError[] {\n  const out: ApiError[] = [];\n\n  if (errors) {\n    Object.keys(errors).forEach((key) => {\n      const messages = makeArray(errors[key]);\n      for (let i = 0; i < messages.length; i++) {\n        let title = 'Invalid Attribute';\n        let pointer = `/data/attributes/${key}`;\n        if (key === PRIMARY_ATTRIBUTE_KEY) {\n          title = 'Invalid Document';\n          pointer = `/data`;\n        }\n        out.push({\n          title: title,\n          detail: messages[i],\n          source: {\n            pointer: pointer,\n          },\n        });\n      }\n    });\n  }\n\n  return out;\n}\n\nfunction findRecord<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data } = context.request;\n  const { record: identifier, options } = data as {\n    record: PersistedResourceKey;\n    options: { reload?: boolean; backgroundReload?: boolean };\n  };\n  upgradeStore(store);\n  assertPrivateStore(store);\n  let promise: Promise<ResourceKey>;\n\n  // if not loaded start loading\n  if (!store._instanceCache.recordIsLoaded(identifier)) {\n    promise = store._fetchManager.fetchDataIfNeededForIdentifier(identifier, options, context.request);\n\n    // Refetch if the reload option is passed\n  } else if (options.reload) {\n    assertIdentifierHasId(identifier);\n\n    promise = store._fetchManager.scheduleFetch(identifier, options, context.request);\n  } else {\n    let snapshot: Snapshot | null = null;\n    const adapter = store.adapterFor(identifier.type);\n\n    // Refetch the record if the adapter thinks the record is stale\n    if (\n      typeof options.reload === 'undefined' &&\n      adapter.shouldReloadRecord &&\n      adapter.shouldReloadRecord(store, (snapshot = store._fetchManager.createSnapshot(identifier, options)))\n    ) {\n      assertIdentifierHasId(identifier);\n      if (DEBUG) {\n        promise = store._fetchManager.scheduleFetch(\n          identifier,\n          Object.assign({}, options, { reload: true }),\n          context.request\n        );\n      } else {\n        options.reload = true;\n        promise = store._fetchManager.scheduleFetch(identifier, options, context.request);\n      }\n    } else {\n      // Trigger the background refetch if backgroundReload option is passed\n      if (\n        options.backgroundReload !== false &&\n        (options.backgroundReload ||\n          !adapter.shouldBackgroundReloadRecord ||\n          adapter.shouldBackgroundReloadRecord(\n            store,\n            snapshot || store._fetchManager.createSnapshot(identifier, options)\n          ))\n      ) {\n        assertIdentifierHasId(identifier);\n\n        if (DEBUG) {\n          void store._fetchManager.scheduleFetch(\n            identifier,\n            Object.assign({}, options, { backgroundReload: true }),\n            context.request\n          );\n        } else {\n          options.backgroundReload = true;\n          void store._fetchManager.scheduleFetch(identifier, options, context.request);\n        }\n      }\n\n      // Return the cached record\n      promise = Promise.resolve(identifier);\n    }\n  }\n\n  return promise.then((i: ResourceKey) => store.peekRecord(i)) as Promise<T>;\n}\n\nfunction findAll<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data } = context.request;\n  const { type, options } = data as {\n    type: string;\n    options: { reload?: boolean; backgroundReload?: boolean };\n  };\n  upgradeStore(store);\n  assertPrivateStore(store);\n  const adapter = store.adapterFor(type);\n\n  assert(`You tried to load all records but you have no adapter (for ${type})`, adapter);\n  assert(\n    `You tried to load all records but your adapter does not implement 'findAll'`,\n    typeof adapter.findAll === 'function'\n  );\n\n  // avoid initializing the liveArray just to set `isUpdating`\n  const maybeRecordArray = store.recordArrayManager._live.get(type);\n  const snapshotArray = new SnapshotRecordArray(store, type, options);\n\n  const shouldReload =\n    options.reload ||\n    (options.reload !== false &&\n      ((adapter.shouldReloadAll && adapter.shouldReloadAll(store, snapshotArray)) ||\n        (!adapter.shouldReloadAll && snapshotArray.length === 0)));\n\n  let fetch: Promise<T> | undefined;\n  if (shouldReload) {\n    // oxlint-disable-next-line no-unused-expressions\n    maybeRecordArray && (maybeRecordArray.isUpdating = true);\n    fetch = _findAll(adapter, store, type, snapshotArray, context.request, true);\n  } else {\n    fetch = Promise.resolve(store.peekAll(type)) as Promise<T>;\n\n    if (\n      options.backgroundReload ||\n      (options.backgroundReload !== false &&\n        (!adapter.shouldBackgroundReloadAll || adapter.shouldBackgroundReloadAll(store, snapshotArray)))\n    ) {\n      // oxlint-disable-next-line no-unused-expressions\n      maybeRecordArray && (maybeRecordArray.isUpdating = true);\n      void _findAll(adapter, store, type, snapshotArray, context.request, false);\n    }\n  }\n\n  return fetch;\n}\n\nfunction _findAll<T>(\n  adapter: MinimumAdapterInterface,\n  store: Store,\n  type: string,\n  snapshotArray: SnapshotRecordArray,\n  request: ImmutableRequestInfo,\n  isAsyncFlush: boolean\n): Promise<T> {\n  const schema = store.modelFor(type);\n  let promise: Promise<T> = Promise.resolve().then(() =>\n    adapter.findAll(store, schema, null, snapshotArray)\n  ) as Promise<T>;\n\n  promise = promise.then((adapterPayload: T) => {\n    assert(\n      `You made a 'findAll' request for '${type}' records, but the adapter's response did not have any data`,\n      payloadIsNotBlank(adapterPayload)\n    );\n    upgradeStore(store);\n    const serializer = store.serializerFor(type);\n    const payload = normalizeResponseHelper(serializer, store, schema, adapterPayload, null, 'findAll');\n\n    store._push(payload, isAsyncFlush);\n    snapshotArray._recordArray.isUpdating = false;\n\n    if (LOG_REQUESTS) {\n      // oxlint-disable-next-line no-console\n      console.log(`request: findAll<${type}> background reload complete`);\n    }\n    return snapshotArray._recordArray;\n  }) as Promise<T>;\n\n  if (TESTING) {\n    if (!request.disableTestWaiter) {\n      promise = waitFor(promise);\n    }\n  }\n\n  return promise;\n}\n\nfunction query<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data } = context.request;\n  upgradeStore(store);\n  assertPrivateStore(store);\n  let { options } = data as {\n    options: { _recordArray?: LegacyQueryArray; adapterOptions?: Record<string, unknown> };\n  };\n  // oxlint-disable-next-line no-shadow\n  const { type, query } = data as {\n    type: string;\n    query: Record<string, unknown>;\n    options: { _recordArray?: LegacyQueryArray; adapterOptions?: Record<string, unknown> };\n  };\n  const adapter = store.adapterFor(type);\n\n  assert(`You tried to make a query but you have no adapter (for ${type})`, adapter);\n  assert(`You tried to make a query but your adapter does not implement 'query'`, typeof adapter.query === 'function');\n\n  const recordArray =\n    options._recordArray ||\n    store.recordArrayManager.getCollection({\n      type,\n      query,\n    });\n\n  if (DEBUG) {\n    options = Object.assign({}, options);\n    delete options._recordArray;\n  } else {\n    delete options._recordArray;\n  }\n  const schema = store.modelFor(type);\n  const promise = Promise.resolve().then(() => adapter.query(store, schema, query, recordArray, options));\n\n  return promise.then((adapterPayload) => {\n    const serializer = store.serializerFor(type);\n    const payload = normalizeResponseHelper(serializer, store, schema, adapterPayload, null, 'query');\n    const identifiers = store._push(payload, true);\n\n    assert(\n      'The response to store.query is expected to be an array but it was a single record. Please wrap your response in an array or use `store.queryRecord` to query for a single record.',\n      Array.isArray(identifiers)\n    );\n\n    store.recordArrayManager.populateManagedArray(recordArray, identifiers, payload as CollectionResourceDocument);\n\n    return recordArray;\n  }) as Promise<T>;\n}\n\nfunction assertSingleResourceDocument(payload: JsonApiDocument): asserts payload is SingleResourceDocument {\n  assert(\n    `Expected the primary data returned by the serializer for a 'queryRecord' response to be a single object or null but instead it was an array.`,\n    !Array.isArray(payload.data)\n  );\n}\n\nfunction queryRecord<T>(context: StoreRequestContext): Promise<T> {\n  const { store, data } = context.request;\n  // oxlint-disable-next-line no-shadow\n  const { type, query, options } = data as { type: string; query: Record<string, unknown>; options: object };\n  upgradeStore(store);\n  const adapter = store.adapterFor(type);\n\n  assert(`You tried to make a query but you have no adapter (for ${type})`, adapter);\n  assert(\n    `You tried to make a query but your adapter does not implement 'queryRecord'`,\n    typeof adapter.queryRecord === 'function'\n  );\n\n  const schema = store.modelFor(type);\n  const promise = Promise.resolve().then(() => adapter.queryRecord(store, schema, query, options)) as Promise<T>;\n\n  return promise.then((adapterPayload: T) => {\n    const serializer = store.serializerFor(type);\n    const payload = normalizeResponseHelper(\n      serializer,\n      store,\n      schema,\n      adapterPayload as Record<string, unknown>,\n      null,\n      'queryRecord'\n    );\n\n    assertSingleResourceDocument(payload);\n\n    const identifier = store._push(payload, true) as ResourceKey;\n    return identifier ? store.peekRecord(identifier) : null;\n  }) as Promise<T>;\n}\n","/**\n * Helps an app migrate incrementally from legacy EmberData patterns to modern ***Warp*Drive**.\n *\n * ## Why it exists\n *\n * While migrating, you may need to:\n *\n * - keep Adapters and Serializers working on a Store whose requests go through the\n *   {@link RequestManager}\n * - keep the deprecated request methods such as `store.findRecord` and `store.query`, which\n *   Adapters fulfill, working while you move calls to `store.request`\n * - adopt modern patterns one piece at a time rather than all at once\n *\n * ## What it provides\n *\n * - {@link LegacyNetworkHandler}, a request handler that fulfills those legacy requests through\n *   the store's Adapters and Serializers and passes every other request along\n * - {@link adapterFor}, {@link serializerFor}, {@link normalize}, {@link pushPayload} and\n *   {@link serializeRecord}, the store methods for working with Adapters and Serializers, and\n *   {@link LegacyStoreCompat}, the Store type that includes them\n *\n * The Store that [useLegacyStore](/api/@warp-drive/legacy/functions/useLegacyStore) produces\n * adds `LegacyNetworkHandler` to its RequestManager unless `linksMode` is `true`. The hooks\n * that present `Model` instances live in [@warp-drive/legacy/model](/api/@warp-drive/legacy/model/),\n * not here.\n *\n * ## When to use it\n *\n * Only during a migration from legacy EmberData to modern ***Warp*Drive**. It lets you adopt\n * modern patterns incrementally while your existing Adapters and Serializers keep working. For\n * incremental migration strategies, see the [Migration Guide](/upgrading/v5/) and the\n * [Two Store Migration Strategy](/upgrading/v5/two-store-migration).\n *\n * @module\n * @summary Legacy store support for adapters and serializers: the `LegacyNetworkHandler` plus store methods such as\n * `adapterFor`, `serializerFor`, `normalize` and `pushPayload`.\n */\n\nimport { getOwner } from '@ember/application';\n\n// RequestManager is imported only so the @module comment can {@link} it.\n// oxlint-disable-next-line no-unused-vars\nimport { recordIdentifierFor, type RequestManager, type Store } from '@warp-drive/core';\nimport { assert } from '@warp-drive/core/build-config/macros';\nimport { _deprecatingNormalize } from '@warp-drive/core/store/-private';\nimport type { ObjectValue } from '@warp-drive/core/types/json/raw';\nimport type { SingleResourceDocument } from '@warp-drive/core/types/spec/json-api-raw';\n\nimport { FetchManager, upgradeStore } from './compat/-private.ts';\nimport type {\n  AdapterPayload,\n  MinimumAdapterInterface,\n} from './compat/legacy-network-handler/minimum-adapter-interface.ts';\nimport type {\n  MinimumSerializerInterface,\n  SerializerOptions,\n} from './compat/legacy-network-handler/minimum-serializer-interface.ts';\n\nexport { LegacyNetworkHandler } from './compat/legacy-network-handler/legacy-network-handler.ts';\n\nexport type { MinimumAdapterInterface, MinimumSerializerInterface, SerializerOptions, AdapterPayload };\n\n/**\n * Extends the signature of {@link Store} with additional\n * methods available when using the legacy network layer.\n *\n * @summary Legacy `Store` type extended with `adapterFor`, `serializerFor`, `normalize`, `pushPayload`, and\n * `serializeRecord` from the adapter and serializer network layer.\n * @public\n * @noInheritDoc\n * @legacy\n */\nexport interface LegacyStoreCompat extends Store {\n  /**\n   * @private\n   */\n  _fetchManager: FetchManager;\n\n  /**\n   * Returns the adapter instance for the given model type, instantiating\n   * it (and caching the instance) if necessary. See {@link adapterFor}.\n   */\n  adapterFor(this: Store, modelName: string): MinimumAdapterInterface;\n  /**\n   * Same as the single-argument overload, but returns `undefined` instead\n   * of throwing/asserting when `_allowMissing` is `true` and no adapter\n   * is found.\n   */\n  adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;\n\n  /**\n   * Returns the serializer instance for the given model type, instantiating\n   * it (and caching the instance) if necessary. See {@link serializerFor}.\n   */\n  serializerFor<K extends string>(modelName: K, _allowMissing?: boolean): MinimumSerializerInterface | null;\n\n  /**\n   * Normalizes a payload for the given model type using its serializer.\n   * See {@link normalize}.\n   */\n  normalize(modelName: string, payload: ObjectValue): ObjectValue;\n\n  /**\n   * Pushes a payload into the store using the appropriate serializer to\n   * normalize it first. See {@link pushPayload}.\n   */\n  pushPayload(modelName: string, payload: ObjectValue): void;\n\n  /**\n   * Serializes a record using its serializer. See {@link serializeRecord}.\n   */\n  serializeRecord(record: unknown, options?: SerializerOptions): unknown;\n\n  /**\n   * @private\n   */\n  _adapterCache: Record<string, MinimumAdapterInterface & { store: Store }>;\n  /**\n   * @private\n   */\n  _serializerCache: Record<string, MinimumSerializerInterface & { store: Store }>;\n}\n\n/**\n * @summary Deprecated alias of `LegacyStoreCompat`, the `Store` type extended with legacy adapter and serializer\n * methods.\n * @deprecated - use {@link LegacyStoreCompat} instead\n */\nexport type CompatStore = LegacyStoreCompat;\n\n/**\n  Returns an instance of the adapter for a given type. For\n  example, `adapterFor('person')` will return an instance of\n  the adapter located at `app/adapters/person.js`\n\n  If no `person` adapter is found, this method will look\n  for an `application` adapter (the default adapter for\n  your entire application).\n\n  @summary Legacy store method that returns the cached adapter for a model type, falling back to the `application`\n  adapter.\n  @public\n  @param modelName\n*/\nexport function adapterFor(this: Store, modelName: string): MinimumAdapterInterface;\nexport function adapterFor(this: Store, modelName: string, _allowMissing: true): MinimumAdapterInterface | undefined;\nexport function adapterFor(this: Store, modelName: string, _allowMissing?: true): MinimumAdapterInterface | undefined {\n  assert(\n    `Attempted to call store.adapterFor(), but the store instance has already been destroyed.`,\n    !(this.isDestroying || this.isDestroyed)\n  );\n  assert(`You need to pass a model name to the store's adapterFor method`, modelName);\n  assert(\n    `Passing classes to store.adapterFor has been removed. Please pass a dasherized string instead of ${modelName}`,\n    typeof modelName === 'string'\n  );\n  upgradeStore(this);\n  this._adapterCache =\n    this._adapterCache || (Object.create(null) as Record<string, MinimumAdapterInterface & { store: Store }>);\n\n  const normalizedModelName = _deprecatingNormalize(modelName);\n\n  const { _adapterCache } = this;\n  let adapter: (MinimumAdapterInterface & { store: Store }) | undefined = _adapterCache[normalizedModelName];\n  if (adapter) {\n    return adapter;\n  }\n\n  const owner = getOwner(this)!;\n\n  // name specific adapter\n  adapter = owner.lookup(`adapter:${normalizedModelName}`) as (MinimumAdapterInterface & { store: Store }) | undefined;\n  if (adapter !== undefined) {\n    _adapterCache[normalizedModelName] = adapter;\n    return adapter;\n  }\n\n  // no adapter found for the specific name, fallback and check for application adapter\n  adapter = _adapterCache.application || owner.lookup('adapter:application');\n  if (adapter !== undefined) {\n    _adapterCache[normalizedModelName] = adapter;\n    _adapterCache.application = adapter;\n    return adapter;\n  }\n\n  assert(\n    `No adapter was found for '${modelName}' and no 'application' adapter was found as a fallback.`,\n    _allowMissing\n  );\n}\n\n/**\n  Returns an instance of the serializer for a given type. For\n  example, `serializerFor('person')` will return an instance of\n  `App.PersonSerializer`.\n\n  If no `App.PersonSerializer` is found, this method will look\n  for an `App.ApplicationSerializer` (the default serializer for\n  your entire application).\n\n  If a serializer cannot be found on the adapter, it will fall back\n  to an instance of `JSONSerializer`.\n\n  @summary Legacy store method that returns the cached serializer for a model type, falling back to the\n  `application` serializer, or `null` if neither exists.\n  @public\n  @param modelName the record to serialize\n  */\nexport function serializerFor(this: Store, modelName: string): MinimumSerializerInterface | null {\n  assert(\n    `Attempted to call store.serializerFor(), but the store instance has already been destroyed.`,\n    !(this.isDestroying || this.isDestroyed)\n  );\n  assert(`You need to pass a model name to the store's serializerFor method`, modelName);\n  assert(\n    `Passing classes to store.serializerFor has been removed. Please pass a dasherized string instead of ${modelName}`,\n    typeof modelName === 'string'\n  );\n  upgradeStore(this);\n  this._serializerCache =\n    this._serializerCache || (Object.create(null) as Record<string, MinimumSerializerInterface & { store: Store }>);\n  const normalizedModelName = _deprecatingNormalize(modelName);\n\n  const { _serializerCache } = this;\n  let serializer: (MinimumSerializerInterface & { store: Store }) | undefined = _serializerCache[normalizedModelName];\n  if (serializer) {\n    return serializer;\n  }\n\n  // by name\n  const owner = getOwner(this)!;\n  serializer = owner.lookup(`serializer:${normalizedModelName}`) as\n    | (MinimumSerializerInterface & { store: Store })\n    | undefined;\n  if (serializer !== undefined) {\n    _serializerCache[normalizedModelName] = serializer;\n    return serializer;\n  }\n\n  // no serializer found for the specific model, fallback and check for application serializer\n  serializer = _serializerCache.application || owner.lookup('serializer:application');\n  if (serializer !== undefined) {\n    _serializerCache[normalizedModelName] = serializer;\n    _serializerCache.application = serializer;\n    return serializer;\n  }\n\n  return null;\n}\n\n/**\n  `normalize` converts a json payload into the normalized form expected by\n  {@link Store.push | push} using the serializer specified by `modelName`\n\n  :::warning\n  Generally it would be better to invoke the serializer yourself directly,\n  or write a more specialized normalization utility.\n  :::\n\n  Example\n\n  ```js\n  socket.on('message', function(message) {\n    let modelName = message.model;\n    let data = message.data;\n    store.push(store.normalize(modelName, data));\n  });\n  ```\n\n  @summary Legacy store method that converts a raw payload into the normalized document `store.push` expects, using\n  the serializer for the given model type.\n  @legacy\n  @public\n  @param modelName The name of the model type for this payload\n  @return The normalized payload\n*/\n// TODO @runspired @deprecate users should call normalize on the associated serializer directly\nexport function normalize(this: Store, modelName: string, payload: ObjectValue): SingleResourceDocument {\n  upgradeStore(this);\n  assert(\n    `Attempted to call store.normalize(), but the store instance has already been destroyed.`,\n    !(this.isDestroying || this.isDestroyed)\n  );\n  assert(`You need to pass a model name to the store's normalize method`, modelName);\n  assert(\n    `Passing classes to store methods has been removed. Please pass a dasherized string instead of ${typeof modelName}`,\n    typeof modelName === 'string'\n  );\n  const normalizedModelName = _deprecatingNormalize(modelName);\n  const serializer = this.serializerFor(normalizedModelName);\n  const schema = this.modelFor(normalizedModelName);\n  assert(\n    `You must define a normalize method in your serializer in order to call store.normalize`,\n    typeof serializer?.normalize === 'function'\n  );\n  return serializer.normalize(schema, payload);\n}\n\n/**\n    Push some raw data into the store.\n\n    This method can be used both to push in brand new\n    records, as well as to update existing records. You\n    can push in more than one type of object at once.\n    All objects should be in the format expected by the\n    serializer.\n\n    ```js [app/serializers/application.js]\n    import RESTSerializer from '@warp-drive/legacy/serializer/rest';\n\n    export default class ApplicationSerializer extends RESTSerializer;\n    ```\n\n    ```js\n    let pushData = {\n      posts: [\n        { id: 1, postTitle: \"Great post\", commentIds: [2] }\n      ],\n      comments: [\n        { id: 2, commentBody: \"Insightful comment\" }\n      ]\n    }\n\n    store.pushPayload(pushData);\n    ```\n\n    By default, the data will be deserialized using a default\n    serializer (the application serializer if it exists).\n\n    Alternatively, `pushPayload` will accept a model type which\n    will determine which serializer will process the payload.\n\n    ```js [app/serializers/application.js]\n    import RESTSerializer from '@warp-drive/legacy/serializer/rest';\n\n     export default class ApplicationSerializer extends RESTSerializer;\n    ```\n\n    ```js [app/serializers/post.js]\n    import JSONSerializer from '@warp-drive/legacy/serializer/json';\n\n    export default JSONSerializer;\n    ```\n\n    ```js\n    store.pushPayload(pushData); // Will use the application serializer\n    store.pushPayload('post', pushData); // Will use the post serializer\n    ```\n\n    @summary Legacy store method that pushes a raw payload into the store after the application serializer, or the\n    given model type's serializer, normalizes it.\n    @public\n    @param modelName Optionally, a model type used to determine which serializer will be used\n    @param inputPayload\n  */\n// TODO @runspired @deprecate pushPayload in favor of looking up the serializer\nexport function pushPayload(this: Store, modelName: string, inputPayload: ObjectValue): void {\n  upgradeStore(this);\n  assert(\n    `Attempted to call store.pushPayload(), but the store instance has already been destroyed.`,\n    !(this.isDestroying || this.isDestroyed)\n  );\n\n  const payload: ObjectValue = inputPayload || (modelName as unknown as ObjectValue);\n  const normalizedModelName = inputPayload ? _deprecatingNormalize(modelName) : 'application';\n  const serializer = this.serializerFor(normalizedModelName);\n\n  assert(\n    `You cannot use 'store.pushPayload(<type>, <payload>)' unless the serializer for '${normalizedModelName}' defines 'pushPayload'`,\n    serializer && typeof serializer.pushPayload === 'function'\n  );\n  serializer.pushPayload(this, payload);\n}\n\n/**\n * Serializes a record using the store's legacy network layer, as with\n * {@link LegacyStoreCompat.serializeRecord | store.serializeRecord}.\n *\n * @summary Legacy store method that serializes a record into a payload using its model type's serializer.\n */\n// TODO @runspired @deprecate records should implement their own serialization if desired\nexport function serializeRecord(this: Store, record: unknown, options?: SerializerOptions): unknown {\n  upgradeStore(this);\n  // TODO we used to check if the record was destroyed here\n  if (!this._fetchManager) {\n    this._fetchManager = new FetchManager(this);\n  }\n\n  return this._fetchManager.createSnapshot(recordIdentifierFor(record)).serialize(options);\n}\n\n/**\n * Destroys any adapters/serializers the legacy network layer has created\n * for this store, invoked when the store itself is destroyed.\n *\n * @summary Legacy store teardown hook that destroys every adapter and serializer instance the store has cached.\n */\nexport function cleanup(this: Store): void {\n  upgradeStore(this);\n  // enqueue destruction of any adapters/serializers we have created\n  for (const adapterName in this._adapterCache) {\n    const adapter = this._adapterCache[adapterName];\n    if (typeof adapter.destroy === 'function') {\n      adapter.destroy();\n    }\n  }\n\n  for (const serializerName in this._serializerCache) {\n    const serializer = this._serializerCache[serializerName];\n    if (typeof serializer.destroy === 'function') {\n      serializer.destroy();\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/unpkg/prod-deprecated/compat.js

@@ -1,3 +1,3 @@
-import { a as serializeRecord, i as pushPayload, n as cleanup, o as serializerFor, r as normalize, s as LegacyNetworkHandler, t as adapterFor } from "./compat-DxiVkCUb.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-PrUuencH.js";
 
 export { LegacyNetworkHandler, adapterFor, cleanup, normalize, pushPayload, serializeRecord, serializerFor };

package/dist/unpkg/prod-deprecated/{errors-ii4L43_1.js → errors-D20lKboZ.js}

@@ -1,5 +1,5 @@
-import { t as upgradeStore } from "./-private-SfXkkHKd.js";
-import { n as decorateMethodV2, r as initializeDeferredDecorator, t as decorateFieldV2 } from "./runtime--fcdnjmJ-DMTJ0Kb3.js";
+import { t as upgradeStore } from "./-private-DuRzYAyW.js";
+import { n as decorateMethodV2 } from "./runtime--fcdnjmJ-5yaSpa-d.js";
 import { assertPrivateStore, createLegacyManyArray, fastPush, isPrivateStore, recordIdentifierFor, storeFor } from "@warp-drive/core/store/-private";
 import { Context } from "@warp-drive/core/reactive/-private";
 import { getOrSetGlobal } from "@warp-drive/core/types/-private";
@@ -10,13 +10,11 @@ import PromiseProxyMixin from "@ember/object/promise-proxy-mixin";
 import ObjectProxy from "@ember/object/proxy";
 import { A } from "@ember/array";
 import ArrayProxy from "@ember/array/proxy";
-import { mapBy, not } from "@ember/object/computed";
 
-//#region src/model/-private/promise-proxy-base.js
+// src/model/-private/promise-proxy-base.js
 const PromiseObject = ObjectProxy.extend(PromiseProxyMixin);
 
-//#endregion
-//#region src/model/-private/promise-belongs-to.ts
+// src/model/-private/promise-belongs-to.ts
 const LegacyPromiseProxy = Symbol.for("LegacyPromiseProxy");
 const Extended = PromiseObject;
 /**
@@ -47,8 +45,7 @@ var PromiseBelongsTo = class extends Extended {
 };
 PromiseBelongsTo.prototype[LegacyPromiseProxy] = true;
 
-//#endregion
-//#region src/model/-private/promise-many-array.ts
+// src/model/-private/promise-many-array.ts
 /**
 This class is returned as the result of accessing an async hasMany relationship
 on an instance of a Model extending from `@warp-drive/legacy/model`.
@@ -62,6 +59,8 @@ In your JS code you should resolve the promise first.
 const comments = await post.comments;
 ```
 
+@summary Legacy promise-like, iterable proxy returned by an async `hasMany` on a `Model`, which templates can
+consume while the related records load.
 @public
 */
 var PromiseManyArray = class {
@@ -229,8 +228,7 @@ function tapPromise(proxy, promise) {
 	});
 }
 
-//#endregion
-//#region src/model/-private/references/has-many.ts
+// src/model/-private/references/has-many.ts
 function isResourceIdentiferWithRelatedLinks$1(value) {
 	return Boolean(value && value.links && value.links.related);
 }
@@ -758,8 +756,7 @@ function ensureRefCanSubscribe(rel) {
 	return true;
 }
 
-//#endregion
-//#region src/model/-private/references/belongs-to.ts
+// src/model/-private/references/belongs-to.ts
 function isResourceIdentiferWithRelatedLinks(value) {
 	return Boolean(value && value.links && value.links.related);
 }
@@ -1253,8 +1250,7 @@ var BelongsToReference = class {
 };
 defineNonEnumerableSignal(BelongsToReference.prototype, "_ref", 0);
 
-//#endregion
-//#region src/model/-private/legacy-relationships-support.ts
+// src/model/-private/legacy-relationships-support.ts
 const LEGACY_SUPPORT = getOrSetGlobal("LEGACY_SUPPORT", /* @__PURE__ */ new Map());
 function releaseLegacySupport(identifier) {
 	const support = LEGACY_SUPPORT.get(identifier);
@@ -1484,13 +1480,14 @@ var LegacySupport = class {
 		if (this.graph) {
 			if (!resource) return;
 			const { definition, state } = relationship;
+			const field = this.store.schema.fields({ type: definition.inverseType }).get(definition.key);
 			/* @__PURE__ */ upgradeStore(this.store);
-			const adapter = this.store.adapterFor?.(definition.type);
+			const isLinksMode = Boolean(field.options.linksMode);
+			const adapter = isLinksMode ? void 0 : this.store.adapterFor?.(definition.type);
 			const { isStale, hasDematerializedInverse, hasReceivedData, isEmpty, shouldForceReload } = state;
 			const allInverseRecordsAreLoaded = areAllInverseRecordsLoaded(this.store, resource);
 			const identifiers = resource.data;
-			const shouldFindViaLink = resource.links && resource.links.related && (typeof adapter?.findHasMany === "function" || typeof identifiers === "undefined") && (shouldForceReload || hasDematerializedInverse || isStale || !allInverseRecordsAreLoaded && !isEmpty);
-			const field = this.store.schema.fields({ type: definition.inverseType }).get(definition.key);
+			const shouldFindViaLink = resource.links && resource.links.related && (isLinksMode || typeof adapter?.findHasMany === "function" || typeof identifiers === "undefined") && (shouldForceReload || hasDematerializedInverse || isStale || !allInverseRecordsAreLoaded && !isEmpty);
 			const request = {
 				useLink: shouldFindViaLink,
 				field,
@@ -1506,6 +1503,12 @@ var LegacySupport = class {
 					method: "GET",
 					records: identifiers || [],
 					data: request,
+					options: {
+						field,
+						identifier: parentIdentifier,
+						links: resource.links,
+						meta: resource.meta
+					},
 					[EnableHydration]: false
 				} : {
 					op: "findHasMany",
@@ -1556,6 +1559,12 @@ var LegacySupport = class {
 				method: "GET",
 				records: identifier ? [identifier] : [],
 				data: request,
+				options: {
+					field,
+					identifier: parentIdentifier,
+					links: resource.links,
+					meta: resource.meta
+				},
 				[EnableHydration]: false
 			} : {
 				op: "findBelongsTo",
@@ -1656,8 +1665,7 @@ function getRealFieldName(context, key) {
 	return field ? field.sourceKey ?? field.name : key;
 }
 
-//#endregion
-//#region src/model/-private/errors.ts
+// src/model/-private/errors.ts
 const ArrayProxyWithCustomOverrides = ArrayProxy;
 /**
 Holds validation errors for a given record, organized by attribute names.
@@ -1785,15 +1793,17 @@ var Errors = class extends ArrayProxyWithCustomOverrides {
 	@public
 	@type {Array}
 	*/
-	static {
-		decorateFieldV2(this.prototype, "messages", [mapBy("content", "message")]);
+	get messages() {
+		return A(this.content.map((error) => error.message));
 	}
-	#messages = (initializeDeferredDecorator(this, "messages"), void 0);
 	/**
 	@property content
 	@type {Array}
 	@private
 	*/
+	static {
+		decorateMethodV2(this.prototype, "messages", [computed("content.@each.message")]);
+	}
 	get content() {
 		return A();
 	}
@@ -1822,10 +1832,9 @@ var Errors = class extends ArrayProxyWithCustomOverrides {
 	@public
 	@readonly
 	*/
-	static {
-		decorateFieldV2(this.prototype, "isEmpty", [not("length")]);
+	get isEmpty() {
+		return !this.length;
 	}
-	#isEmpty = (initializeDeferredDecorator(this, "isEmpty"), void 0);
 	/**
 	Manually adds errors to the record. This will trigger the `becameInvalid` event/ lifecycle method on
 	the record and transition the record into an `invalid` state.
@@ -1857,6 +1866,9 @@ var Errors = class extends ArrayProxyWithCustomOverrides {
 	@param {String} attribute - the property name of an attribute or relationship
 	@param {string[]|string} messages - an error message or array of error messages for the attribute
 	*/
+	static {
+		decorateMethodV2(this.prototype, "isEmpty", [computed("length")]);
+	}
 	add(attribute, messages) {
 		const errors = this._findOrCreateMessages(attribute, messages);
 		this.addObjects(errors);
@@ -1980,6 +1992,5 @@ var Errors = class extends ArrayProxyWithCustomOverrides {
 	}
 };
 
-//#endregion
 export { PromiseManyArray as a, releaseLegacySupport as i, LEGACY_SUPPORT as n, PromiseBelongsTo as o, lookupLegacySupport as r, Errors as t };
-//# sourceMappingURL=errors-ii4L43_1.js.map
+//# sourceMappingURL=errors-D20lKboZ.js.map